Glossary
Public Pack — The shareable narrative draft. It is conservative until gates close.
Gate — A specific missing proof point (or wording risk) that must be resolved before we strengthen claim language.
Library — The reading list and evidence map. Shows which sources were read, used, or quoted.
Warehouse — The internal store of captured document text (so we can search and quote consistently). Readers usually don’t need this term; we use it to keep work organized.
Claims ledger — A checklist of statements and their support level: supported / provisional / gated.
Scope lock — A written boundary on what we will and won’t cover, so the project stays focused.
Version — A named snapshot of the pack. Versions help reviewers see deltas and keep feedback aligned to a specific draft.
Quality controls (what they accomplish)
- Clarity-first packaging: each page explains itself before it asks you to read details.
- Evidence-first wording: we avoid upgrading tone until documentation is in hand.
- Auditable changes: we keep a delta log so edits don’t silently drift.
Recommended review path (for first-time reviewers)
- Status — get the one-screen overview and see open risks.
- Public Pack — read the narrative and mark anything that feels unclear or too strong.
- Gates — check which uncertainties are already recognized and prioritized.
- Library — spot-check the sources and excerpts (you don’t need to read everything).
- What we need from Jonny — if you can answer one or two questions, do that next.