Guides

Guide Fit

flowchart TD
  family["Reproducible Research"] --> program["Deep Dive Snakemake"]
  program --> pressure["A concrete learner or reviewer question"]
  pressure --> guide["Guides"]
  guide --> next["Modules, capstone, and reference surfaces"]

flowchart TD
  question["Name the exact question you need answered"] --> choose["Choose one guide lane"]
  choose --> act["Open one page, not the whole shelf"]
  act --> next_move["Leave with one next page, command, or proof route"]

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
workflow split decisions	Workflow Modularization	Boundary Map
capstone entry	Capstone Guide	Capstone Map

Study routes

• Start Here for the shortest stable route into the course
• Course Guide for the role of each support surface
• Learning Contract for the teaching bar and proof expectations
• Pressure Routes for repair, stewardship, and incident entry paths
• Platform Setup before you run local proof commands

Module support

• Workflow Modularization when the question is how far to split the repository
• Module Promise Map when you want each title translated into a learner contract
• Module Checkpoints when you need an exit bar before moving on
• Module Dependency Map when the reading order needs justification
• Practice Map when you want the module-to-proof loop in one place

Proof and command routes

• Proof Ladder for choosing the smallest honest route
• Proof Matrix for routing a claim to the right evidence surface
• Boundary Map when you need workflow-versus-policy separation
• Glossary when the vocabulary itself is the blocker
• Command Guide for command boundaries

Capstone entry routes

• Capstone Guide for the repository contract
• Capstone Map for module and question routing
• Capstone Walkthrough for a bounded first pass
• Capstone Proof Guide for the shortest proof route
• Capstone Review Worksheet for steward-level workflow review
• Capstone Extension Guide for safe evolution

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.

Directory glossary

Use Glossary when you want the recurring language in this shelf kept stable while you move between study routes, proof routes, and support pages.