Guides

Page Maps

graph LR
  family["Reproducible Research"]
  program["Deep Dive DVC"]
  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
durable review and boundary standards	Review Checklist	Boundary Review Prompts
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 repository drift 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 declaration, execution, promotion, and recovery	Capstone Architecture Guide
verification depth for publish, experiment, or recovery questions	Capstone Proof Guide
steward-level repository 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 define DVC from scratch. The goal is to keep a small set of course-level terms stable so you can move between guides, modules, and capstone routes without changing what the words mean halfway through.

Terms that matter on this shelf

Term	Meaning here	Why it matters
reading route	a short reading path for one concrete question	keeps you from opening five pages when one page would do
trust question	the exact reproducibility claim you are trying to settle	stops the course from turning into command memorization
authoritative layer	the file or state surface that should win when two surfaces disagree	keeps review tied to state ownership instead of habit
proof route	the smallest command, artifact, or file that can honestly test a claim	keeps evidence proportional to the question
publish boundary	the smaller downstream-facing bundle another person is allowed to trust	separates internal repository state from released state
recovery surface	the files and commands that prove local loss is survivable	keeps durability claims from becoming wishful thinking
capstone entry	the first bounded route into the executable repository	prevents the capstone from becoming first-contact reading
bounded review	an inspection pass with a clear stopping point	stops review from turning into aimless browsing

Guide names in plain language

Page	What it is for
Start Here	safest first route into the program
Course Guide	overview of when to use guides, modules, reference pages, or capstone routes
Learning Contract	the bar the course sets for explanation, proof, and honest progress
Module Promise Map	translation of module titles into concrete outcomes you should reach
Module Checkpoints	readiness review before you move on
Platform Setup	tooling and setup checks before you trust local proof routes
Pressure Routes	shortest honest route when urgency is shaping the reading order
Proof Ladder	how to choose a smaller or larger proof route without guessing
Proof Matrix	where a specific claim is first corroborated
Course Guide	how to decide what counts as authoritative state and what actually proves it

Reading rule

If a guide name still feels vague after you read the tables above, do not open three more guides. Name the job first, pick the one page that owns that job, and stop when you have one clear next move.