Vijay Janapa Reddi
4c0a046953
Remove emoji prefixes from markdown headers in milestones and site chapters
2025-11-11 21:17:22 -05:00
Vijay Janapa Reddi
f4a40ab655
Update milestones.md to reflect standardized milestone structure
...
Aligned website milestone documentation with the comprehensive README files:
1. Updated milestone naming consistency:
- M06: '2024 Systems Age' → '2018 MLPerf' (historically accurate)
- Updated Acts table to reflect correct module ranges
2. Fixed all script paths to match new naming convention:
- M01: perceptron_trained.py → 01_rosenblatt_forward.py + 02_rosenblatt_trained.py
- M02: xor_crisis folder → xor folder, updated script names
- M05: vaswani_shakespeare.py → 01_vaswani_generation.py + 02_vaswani_dialogue.py
- M06: optimize_models.py → 01_baseline_profile.py + 02_compression.py + 03_generation_opts.py
3. Enhanced M06 (MLPerf) section:
- Added historical context (2018 MLCommons establishment)
- Explained systematic optimization methodology
- Included quantitative results (8-16× compression, 12-40× speedup)
- Shows 3-script progressive optimization workflow
4. Maintained excellent 'Two Dimensions' framing:
- Pedagogical Acts (WHY you're learning)
- Historical Milestones (WHAT you can build)
- Connection table showing how they relate
Documentation hierarchy: Milestone READMEs are canonical source,
website milestones.md provides overview + navigation.
2025-11-11 18:31:04 -05:00
Vijay Janapa Reddi
4bf15af074
Add pedagogical narrative: The Learning Journey
...
Created comprehensive six-act narrative explaining module progression:
- Act I: Foundation (01-04) - Building atomic components
- Act II: Learning (05-07) - The gradient revolution
- Act III: Data & Scale (08-09) - Real-world complexity
- Act IV: Language (10-13) - Sequential intelligence
- Act V: Production (14-19) - Optimization & deployment
- Act VI: Integration (20) - Complete AI systems
Changes:
1. Created site/chapters/learning-journey.md
- Complete pedagogical narrative (6 acts, ~500 lines)
- Explains WHY modules flow this way
- Shows HOW each act builds on previous
- Connects to milestones and tier structure
- Student guidance for using the narrative
2. Updated site/intro.md (landing page)
- Added "Understanding Your Complete Learning Journey" section
- Three-card navigation: Tiers + Acts + Milestones
- Guides students to three complementary views
3. Updated site/chapters/milestones.md
- Added "Two Dimensions of Your Progress" section
- Shows pedagogical (acts) vs historical (milestones) dimensions
- Mapping table connecting acts to unlocked milestones
4. Updated site/chapters/00-introduction.md
- Added cross-reference to learning-journey.md
- Links pedagogical narrative to tier structure
5. Updated site/_toc.yml
- Added learning-journey.md to Course Orientation section
- Reorganized: Structure → Journey → Milestones
Rationale:
Website had WHAT (tiers), WHEN (milestones), WHERE (progress),
but lacked WHY (pedagogical progression) and HOW (learning story).
Learning journey fills this gap - explains module flow from atoms
to intelligence through narrative arc.
Uses both "tiers" (structure) and "acts" (narrative) complementarily.(https://claude.com/claude-code )
2025-11-11 18:22:35 -05:00
Vijay Janapa Reddi
56419ea4c2
Standardize milestone naming with numbered sequence and historical anchors
...
Applied consistent naming pattern: 0X_[figure]_[task].py
M01 (1957 Perceptron):
- forward_pass.py → 01_rosenblatt_forward.py
- perceptron_trained.py → 02_rosenblatt_trained.py
M02 (1969 XOR):
- xor_crisis.py → 01_xor_crisis.py
- xor_solved.py → 02_xor_solved.py
M03 (1986 MLP):
- mlp_digits.py → 01_rumelhart_tinydigits.py
- mlp_mnist.py → 02_rumelhart_mnist.py
M04 (1998 CNN):
- cnn_digits.py → 01_lecun_tinydigits.py
- lecun_cifar10.py → 02_lecun_cifar10.py
M05 (2017 Transformer):
- vaswani_chatgpt.py → 01_vaswani_generation.py
- vaswani_copilot.py → 02_vaswani_dialogue.py
- profile_kv_cache.py → 03_vaswani_profile.py
Benefits:
- Clear execution order (01, 02, 03)
- Historical context (rosenblatt, lecun, vaswani)
- Descriptive purpose (generation, dialogue, profile)
- Consistent structure across all milestones
Updated documentation:
- README.md: Updated all milestone examples
- site/chapters/milestones.md: Updated bash commands
2025-11-11 12:20:36 -05:00
Vijay Janapa Reddi
9ad2524bf2
Add jupyter-book to site/requirements.txt
...
- Added jupyter-book>=0.15.0,<1.0.0 dependency for documentation builds
- This dependency is referenced by GitHub Actions workflows
- Required for both HTML and PDF book generation
2025-11-11 11:56:25 -05:00
Vijay Janapa Reddi
a5679de141
Update documentation after module reordering
...
All module references updated to reflect new ordering:
- Module 15: Quantization (was 16)
- Module 16: Compression (was 17)
- Module 17: Memoization (was 15)
Updated by module-developer and website-manager agents:
- Module ABOUT files with correct numbers and prerequisites
- Cross-references and "What's Next" chains
- Website navigation (_toc.yml) and content
- Learning path progression in LEARNING_PATH.md
- Profile milestone completion message (Module 17)
Pedagogical flow now: Profile → Quantize → Prune → Cache → Accelerate
2025-11-10 19:37:41 -05:00
