[Tracking] Documentation truth-up epic — execution checklist

[Polichinel]

Tracking issue for the Documentation truth-up epic (#70). Work the stories in order; check each off as its PR merges to development.

Execution order

• S1 S1 — Decide documentation information architecture + ADR-supersession policy #71 — Documentation IA + ADR-supersession policy planning needs-decision (gates all)
• S2 S2 — Write the role & seams orientation doc #72 — Role & seams orientation doc documentation (dep: S1)
• S3 S3 — Rewrite the README to current reality #73 — Rewrite the README to current reality documentation (dep: S1, S2)
• S4 S4 — Truth-up the foundational ADRs (001 ontology, 002 topology, index) #74 — Truth-up the foundational ADRs (001 / 002 / index) documentation (dep: S1, S2)
• S5 S5 — Refresh module-level docs + package-layout map; remove dead links #75 — Module-level docs + package-layout map; kill dead links documentation (dep: S3)
• S6 S6 — Doc-accuracy guardrail (prevent silent re-staling) #76 — Doc-accuracy guardrail testing (dep: S2–S5)
• Close epic [EPIC] Documentation truth-up: make the docs describe what views-postprocessing actually is #70

Dependency notes

S1 ─┬─► S2 ─┬─► S3 ──► S5 ─┐
    │       └─► S4         ├─► S6
    └───────────►          ┘

• S1 gates everything (it's needs-decision — get the maintainer call first).
• S2 before S3 and S4 (both link/align to the orientation doc).
• S3 before S5 (S5 builds on the README's package-structure + terminology).
• S6 last — it validates S2–S5 and must land green.

Conventions

• Docs-only epic — no code/behavior changes; the S6 guardrail is the only non-prose addition.
• Each story is its own PR → development, with the usual ritual (ruff/tests green; CI; merge; manual issue close since auto-close doesn't fire on development merges).
• Out of scope (do not fold in here): Document post-delivery correction procedure for wrong assignments (C-22) #15 (operational data-correction procedure — needs FAO input), the C-40/frames migration, the historical cross_repo_integration_report.md / reconciliation_migration.md.

[Polichinel]

All stories merged to development (S1 #71 → S6 #76, PRs #78–#83). The doc-accuracy guardrail (#76) is live and green. Epic #70 complete. Closing tracker.