mirror of
https://github.com/MLSysBook/TinyTorch.git
synced 2026-08-02 10:58:25 -05:00
Enhance figure captions with pedagogical explanations
Transform figure captions from purely descriptive to explanatory, matching the pedagogical style used for code listings. Figure 2 (Module dependency flow): - Before: Basic description of color coding and dotted lines - After: Explains HOW students build incrementally, WHY the structure matters (mirrors compiler courses), and WHAT each tier accomplishes (foundation enables architectures enables optimization) - Adds concrete examples: autograd M05 requires tensors M01, benchmarking M19 requires all architectures Figure 3 (Progressive disclosure): - Before: Technical description of dormant vs active features - After: Explains the LEARNING BENEFITS with numbered list: (1) Early API familiarity avoids interface surprise (2) Forward compatibility demonstrated through unchanged code (3) Curiosity-driven motivation through visible inactive features - Adds concrete example: 'Why does .backward() exist if we can't use it yet?' question motivates curriculum progression Both captions now explain not just WHAT the figure shows, but WHY it matters for learning and HOW it supports the pedagogical approach. This addresses user feedback about making figures as explanatory as code listings. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude
parent
f3de9804ae
commit
2eec9ff736
+2
-2
@@ -363,7 +363,7 @@ The curriculum follows the compiler course model~\citep{aho2006compilers}: stude
|
||||
|
||||
\end{tikzpicture}%
|
||||
}
|
||||
\caption{Module dependency flow: How components connect across tiers. Foundation modules (blue) enable architectures (purple), which are optimized (green), culminating in the capstone competition (red). Dotted lines show cross-tier integration.}
|
||||
\caption{Module dependency flow shows how students build a complete ML framework incrementally. Foundation modules (blue, M01-07) provide core tensor operations and training infrastructure. These enable architecture modules (purple, M08-13) where students implement CNNs and transformers using only their own code. Optimization modules (green, M14-19) teach production concerns: profiling, quantization, and deployment. Solid arrows show direct dependencies (e.g., autograd M05 requires tensors M01); dotted lines show cross-tier integration (e.g., benchmarking M19 requires all architectures). This structure mirrors compiler courses: each module builds on previous work, creating systems thinking through component integration.}
|
||||
\label{fig:module-flow}
|
||||
\end{figure}
|
||||
|
||||
@@ -738,7 +738,7 @@ print(x.grad) # [6.0] - dy/dx = 2x
|
||||
\node[active, minimum width=1.0cm, minimum height=0.4cm] at (5.5, -1.5) {Active};
|
||||
|
||||
\end{tikzpicture}
|
||||
\caption{Progressive activation of Tensor gradient features. Dormant placeholders (gray, dashed) exist from Module 01. Module 05 activates full autograd functionality (orange, solid) via runtime method enhancement.}
|
||||
\caption{Progressive disclosure manages cognitive load through runtime feature activation. From Module 01, students see the complete Tensor API including gradient methods (\texttt{.backward()}, \texttt{.grad}, \texttt{.requires\_grad}), but these features remain dormant (gray, dashed)—they exist as placeholders that return gracefully. In Module 05, runtime method enhancement activates full autograd functionality (orange, solid) without breaking earlier code. This creates three learning benefits: (1) students learn the complete API early, avoiding interface surprise later; (2) Module 01 code continues working unchanged when autograd activates, demonstrating forward compatibility; (3) visible but inactive features create curiosity-driven questions ("Why does \texttt{.backward()} exist if we can't use it yet?") that motivate curriculum progression.}
|
||||
\label{fig:progressive-timeline}
|
||||
\end{figure*}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user