10 lines
587 B
Markdown
10 lines
587 B
Markdown
# Documentation subtree rules
|
|
|
|
- Read `docs/authority.toml` before treating a document as current.
|
|
- Canonical docs describe current behavior; active plans describe incomplete work; accepted ADRs
|
|
describe decisions and constraints; evaluations describe dated evidence.
|
|
- Historical and superseded documents are not current requirements.
|
|
- Do not duplicate detailed contracts across README, guides, plans, ADRs, and tracker bodies.
|
|
- Update the smallest canonical surface that owns the changed behavior.
|
|
- Run `scripts/codex/docs_audit.py` through the documentation-integrity workflow.
|