Salon/docs/documentation.md

Documentation Rules

Principles

• Single source of truth per topic; link, do not duplicate.
• Update docs in same change set as code.
• Prefer observable behavior (what to run, what to see).

Canonical Locations

• Architecture/system boundaries: docs/architecture.md
• Execution plans: docs/execplans/ + policy in docs/PLANS.md
• Operational procedures: docs/runbooks/
• Cross-cutting decisions: docs/adr/
• Known gaps: docs/risks.md

Minimum Review Checklist

• Docs touched or explicitly unchanged.
• Runbook updated for production-impacting flow changes.
• ADR added when decision is hard to reverse.
• Risks updated when a major gap opens/closes.