Repository Foundation¶
The repository is structured as a versioned documentation system.
Canonical Directories¶
| Directory | Role |
|---|---|
docs/ |
Published Playbook pages. |
docs/00-Foundation/ |
Repository governance and documentation standards. |
templates/ |
Reusable source templates for new content. |
adr/ |
Architecture Decision Records. |
diagrams/ |
Diagram sources and exports. |
scripts/ |
Maintenance and automation scripts. |
Numbered Sections¶
The Playbook uses numbered sections so ordering remains stable in source control and rendered navigation.
New top-level sections require an approved structure change. New pages inside existing sections should follow the naming and metadata conventions in this Foundation section.
Publication Boundary¶
MkDocs publishes content from docs/. Supporting repository assets such as ADR source files, templates, scripts, and diagrams remain outside the rendered navigation unless intentionally referenced or copied into docs/.