Current section
Files
Jump to
Current section
Files
priv/toolchain/migrations/0.11.5.md
# 0.11.5 — the ADR index leaves the canon (issue #34)
`docs/adr/README.md`'s `## Index` section was a hand-maintained
enumeration recoverable from the directory listing — the exact form
`principles.md` §1 forbids — and as canon-enforced content it produced
a standing `undeclared canon drift` finding on every repo that obeyed
its own instruction, plus an upgrade-clobber hazard.
## The one step
Delete the `## Index` section (heading, table, everything under it)
from `docs/adr/README.md`; the canon reconcile installs the
replacement text ("The index is a query, not a file"). Before
deleting: any `Topic` cell that carries prose NOT recoverable from the
ADR's content-named filename is content — quote each such cell in the
migration PR body (rare; a topic that differs from its filename
usually signals the file wants renaming under the content-naming
rule).
## Confirm
`dds` reports no drift on `docs/adr/README.md`; the directory listing
and `dds issues` serve what the index served.