README

tech-studies

A structured wiki for studying tech, organized around every roadmap.sh roadmap. Each roadmap is a suggested path of nodes; each node can have a lesson that teaches it.

Live site: https://iagodantasf.github.io/tech-studies/

This is an Obsidian-compatible vault. Pages are plain markdown with frontmatter, [[wikilinks]], and #tags. Open the folder as a vault for backlinks + graph, or browse the published site / GitHub.

90 roadmaps are mapped across four types — role-based, skill-based, best-practices, beginner. Computer Science is the fully-written worked example: 33 lessons across Foundations, Data structures, Algorithms, Complexity, Math & bits, Systems, and Theory. The rest are roadmap paths waiting for lessons — see CATALOG.md for coverage.

Quickstart

# scaffold a new roadmap (creates roadmaps/<catDir>/<slug>/ from the template)
./scripts/new-roadmap.sh computer-science
 
# write a lesson for one of its nodes
./scripts/new-lesson.sh computer-science "Data structures" "Hash tables"
 
# regenerate the catalog (coverage per roadmap)
node scripts/build-dashboard.mjs

Then open CATALOG.md for coverage across all roadmaps.

Layout

Path	What
CATALOG.md	Coverage (lessons written / nodes) across every roadmap (generated)
CONVENTIONS.md	The wiki model + how lessons are structured
roadmaps/<catDir>/<slug>/	One roadmap per topic: a grouped node path + lessons/ + resources
playgrounds/<lang>/	Runnable code experiments, organized by language/tool
projects/	Larger practice builds
library/	Notes on books, courses, papers
templates/	Lesson + roadmap scaffolds
scripts/	Automation (scaffold roadmaps/lessons, build the catalog)

Roadmaps are filed by type — role-based, skill-based, best-practices, beginner — so the explorer groups them.

How it’s structured

Read CONVENTIONS.md — it defines the roadmap → node → lesson model, the frontmatter, tags, and the lessons/<group>/index.md maps of content.