Guides¶
Page Maps¶
graph LR
family["Reproducible Research"]
program["Deep Dive Make"]
section["Guides"]
page["Guides"]
capstone["Capstone evidence"]
family --> program --> section --> page
page -.applies in.-> capstone
flowchart LR
orient["Orient on the page map"] --> read["Read the main claim and examples"]
read --> inspect["Inspect the related code, proof, or capstone surface"]
inspect --> verify["Run or review the verification path"]
verify --> apply["Apply the idea back to the module and capstone"]
Read the first diagram as a timing map: the guides shelf is for a named pressure, not for wandering the whole course-book. Read the second diagram as the guide loop: choose one lane, use one page, then leave with one smaller next move.
Use this shelf when you need route choice, proof sizing, or capstone entry help rather than one module chapter.
Choose one lane¶
| If you need... | Start here | Then use |
|---|---|---|
| the shortest honest entry | Start Here | Course Guide |
| the full support-page map | Course Guide | Learning Contract |
| a route shaped by urgency | Pressure Routes | Proof Ladder |
| module promises and exit bars | Module Promise Map | Module Checkpoints |
| proof selection | Proof Ladder | Proof Matrix |
| capstone entry | Capstone Guide | Capstone Map |
Use the shelf by job¶
| Job | Best page |
|---|---|
| understand the module arc and support-page roles | Course Guide |
| see the sequence justified | Module Dependency Map |
| rehearse the module-to-proof loop | Practice Map |
| hold the stable review bar steady | Review Checklist |
| sharpen a keep, change, or reject boundary call | Boundary Review Prompts |
| spot common failure classes faster | Anti-Pattern Atlas |
| route a claim to executable evidence | Proof Matrix |
| choose the smallest honest proof route | Proof Ladder |
| confirm the local environment before public commands | Platform Setup |
Cross into the capstone deliberately¶
| If you need... | Best page |
|---|---|
| the capstone's role in the course | Capstone |
| the module-to-repository route | Capstone Map |
| a bounded first pass through the repository | Capstone Walkthrough |
| file responsibilities inside the repository | Capstone File Guide |
| ownership boundaries across graph, proof, and release surfaces | Capstone Architecture Guide |
| one end-to-end proof pass | Capstone Proof Guide |
| steward-level review | Capstone Review Worksheet |
| safe evolution | Capstone Extension Guide |
Good stopping point¶
Stop when you can name the single next page you need and the question it is supposed to answer. If you are still opening whole shelves, go back to the table above and choose a smaller lane.
Shelf vocabulary¶
Use this section when the support shelf starts sounding more abstract than the course
intends. The goal is not to add theory. The goal is to keep a small set of terms stable
so you can move between guides/, the modules, and the capstone without quietly
changing what a word means.
Terms that matter on this shelf¶
| Term | Meaning here | Why it matters |
|---|---|---|
| reading route | a short, deliberate reading path for one question | prevents wandering through five pages when one page would do |
| pressure | the concrete situation shaping how you read right now | keeps the guides tied to real use instead of generic study advice |
| proof route | the smallest command, file, or bundle that can honestly answer the current claim | keeps evidence proportional to the question |
| support shelf | the guides/ directory as a whole |
reminds you these pages are helpers, not substitute chapters |
| module promise | the practical contract a module is supposed to deliver | helps you judge whether a module actually taught what its title implies |
| checkpoint | the readiness bar for moving on from a module | stops recognition from masquerading as understanding |
| capstone entry | the first bounded route into the executable repository | keeps the capstone from becoming first-contact reading |
| bounded review | an inspection pass with a clear stopping point | keeps review from growing into unstructured browsing |
Guide names in plain language¶
| Page | What it is for |
|---|---|
| Start Here | first entry when you need the safest route into the course |
| Course Guide | overview of when to use modules, guides, capstone pages, or reference maps |
| Learning Contract | the bar the course sets for explanation, proof, and honest progress |
| Module Promise Map | translation of module titles into the outcomes you should reach |
| Module Checkpoints | readiness review before you move on |
| Platform Setup | tooling and command boundary checks before you rely on local results |
| Proof Ladder | how to choose a smaller or larger proof route without guessing |
| Proof Matrix | where a specific claim is first corroborated |
| Pressure Routes | shortest route when urgency, repair work, or stewardship is shaping the reading order |
Reading rule¶
If a guide name still sounds fuzzy after you read the table above, do not open three more guides. Pick the page whose question most closely matches yours, use it, and stop when you have one clear next move.