Skip to content

documentation-placement

Tracked Markdown must have a durable documentation or tool-contract role.

Why

Owned documentation stays discoverable instead of becoming repository debris.

Fix

Move durable guidance into an approved docs root or delete transient notes.

Examples

Markdown placement

Before — rejected · error
deployments/alpha/terraform/README.md
After — preferred
docs/deployment/alpha-terraform.md