Use this guide to navigate all tutorial tracks, understand structure rules, and jump to the right discovery surface quickly.
- Main catalog and learning paths: ../README.md
- A-Z tutorial directory: ../discoverability/tutorial-directory.md
- Intent-based discovery: ../discoverability/query-hub.md
- Search intent mapping: ../discoverability/search-intent-map.md
- Contribution workflow: ../CONTRIBUTING.md
| Metric | Value |
|---|---|
| Tutorial directories | 201 |
| Tutorial markdown files | 1812 |
| Tutorial markdown lines | 730,014 |
Repository-source verification run against tutorial index references (GitHub API, 2026-02-24):
| Signal | Value |
|---|---|
| Tutorials scanned | 201 |
| Tutorials with source repos | 201 |
| Tutorials with unverified source repos | 0 |
| Unique verified source repos | 214 |
- Report: ../discoverability/tutorial-source-verification.md
- JSON: ../discoverability/tutorial-source-verification.json
- Script: ../scripts/verify_tutorial_sources.py
| Pattern | Count | Description |
|---|---|---|
| Root chapter files | 201 | README.md + top-level 01-...md to 08-...md |
docs/ chapter files |
0 | Deprecated and fully migrated |
| Index-only roadmap | 0 | All catalog entries publish full chapter sets |
Mixed root + docs/ |
0 | Legacy hybrid layout removed |
Each tutorial index should provide:
- a clear chapter guide with direct links
- source references to upstream docs/repos
- related tutorial links for cross-track navigation
- a Navigation & Backlinks section to connect back to core discovery surfaces
Each tutorial directory should contain:
README.md01-...mdthrough08-...mdat the tutorial root (not underdocs/)
# Refresh tutorial metrics and structure snapshot
python3 scripts/update_tutorials_readme_snapshot.py --root .
# Re-verify tutorial source repositories
python3 scripts/verify_tutorial_sources.py --root .
# Run docs health checks
python3 scripts/docs_health.py --root .- Browse all tutorials: ../README.md#-tutorial-catalog
- Explore category hubs: ../README.md#category-hubs
- Open new tutorial request: https://github.com/johnxie/awesome-code-docs/issues/new?template=new-entry.md