TRIAGE¶
Scope: Triage rules for documentation lifecycle.
Audience: Contributors deciding doc changes.
Guarantees: Docs exist only when tied to code.
Non-Goals: Content authoring guidance.
Why: This doc exists to record its single responsibility for review.
Overview¶
This doc defines one responsibility.
Architecture components are defined in Architecture.
Read Docs Style before edits.
Read Spine for context.
Contracts¶
Each statement is a contract.
Contracts align with tests/unit/test_docs_contract.py.
Contracts link to Docs Style and Spine.
Invariants¶
Invariants describe stable behavior.
Checks align with tests/unit/test_docs_contract.py.
Invariants align with Docs Style.
Failure Modes¶
Failures are explicit and tested.
Failure coverage aligns with tests/unit/test_docs_contract.py.
Failures align with Spine.
Extension Points¶
Extensions require tests and docs.
Extensions are tracked in Docs Style.
Extensions align with tests/unit/test_docs_contract.py.
Exit Criteria¶
This doc becomes obsolete when the surface ends.
The replacement is linked in Spine.
Obsolete docs are removed.
Code refs: tests/unit/test_docs_contract.py.