Skip to content

feat: migrate all 61 v1 tutorials to format_version v2#157

Merged
johnxie merged 1 commit intomainfrom
feat/v2-migration-rebased
Mar 21, 2026
Merged

feat: migrate all 61 v1 tutorials to format_version v2#157
johnxie merged 1 commit intomainfrom
feat/v2-migration-rebased

Conversation

@johnxie
Copy link
Copy Markdown
Owner

@johnxie johnxie commented Mar 21, 2026

Summary

  • Migrate all 61 remaining v1 tutorials to format_version: v2
  • Add ## Why This Track Matters section to all 61 (tutorial-specific prose)
  • Add ## Mental Model heading above existing mermaid diagrams in 42 tutorials
  • Fix heading mismatches across tutorials to pass v2 validator
  • Add missing ## What You Will Learn sections to 8 tutorials
  • 191/191 tutorials now pass v2 format validation (was 130/191)

Test plan

  • check_index_format_v2.py — 191 v2 indexes, all compliant
  • docs_health.py — 0 broken links, 0 missing indexes
  • staleness_audit.py — 0 stale markers
  • CI Docs Health check passes

- Add format_version: v2 to frontmatter of all 61 remaining tutorials
- Add "Why This Track Matters" section to all 61 (tutorial-specific)
- Add "Mental Model" heading above existing mermaid diagrams (42 tutorials)
- Fix heading mismatches to pass v2 validator
- Add missing "What You Will Learn" sections (8 tutorials)
- 191/191 tutorials now pass v2 format validation
@johnxie johnxie merged commit d3cc9f0 into main Mar 21, 2026
1 check passed
@johnxie johnxie deleted the feat/v2-migration-rebased branch March 21, 2026 05:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant