Skip to content

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.