Skip to content

Commit b460686

Browse files
authored
docs(adr): allow renumbering and deletion when the set is reshaped (#34)
1 parent 797918a commit b460686

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

‎docs/adr/README.md‎

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,19 @@ the standard below is held up by review.
77

88
## Numbering
99

10-
Numbers run contiguously from `0001`, are permanent, and mean nothing beyond
11-
identity. A new ADR takes the next free number. Nothing is ever renumbered.
10+
Numbers run contiguously from `0001` and mean nothing beyond identity. A new
11+
ADR takes the next free number. When the set is reshaped, because records were
12+
merged or dropped, the survivors are renumbered in their original order so the
13+
sequence stays contiguous, and every citation moves in the same change:
14+
`tests/test_adr_citations.py` fails on a `docs/adr/` path that no longer
15+
resolves.
1216

1317
## Status lives in the frontmatter, or nowhere
1418

15-
An ADR with no frontmatter is **accepted**. There is no exit from this
16-
directory: a superseded decision stays readable, or it gets re-argued.
19+
An ADR with no frontmatter is **accepted**. A decision that is re-argued and
20+
replaced is superseded, not deleted, so the earlier reasoning stays readable. A
21+
record that no longer passes the admission test below is deleted outright; git
22+
history keeps it.
1723

1824
When a later ADR supersedes an earlier one, add to the earlier file:
1925

0 commit comments

Comments
 (0)