bible/kit/docs/bible-skeleton/governance/documentation-policy.md

Documentation Policy

Purpose

This policy defines how architectural knowledge is captured and maintained.

Mandatory Rules

• Record every architecture decision in the Bible before or together with implementation.
• Use English for all architecture documentation.
• Keep only current architecture in active sections.
• When a solution is replaced, update or remove obsolete guidance in the same change.
• Keep architecture details centralized in bible/; other top-level docs should only reference it.

Change Workflow

1. Update the relevant file(s) in bible/architecture/.
2. If behavior changed, add or update a decision note in bible/decisions/.
3. Remove duplicated or outdated statements from non-Bible docs.
4. Validate consistency against current code paths.