Cut every record's status line to one line, and keep one index by domain - #974
Merged
Merged
Conversation
Status lines had become change logs: five ran past a thousand characters, the README repeated them in a second copy, and docs/design kept a third table that stopped at 0045. Each record now says its status in one line (a status word, the date and PR, what is open); the line that stood before is kept verbatim at the end of the record under Status history. The README has one index grouped by domain that repeats only the status word, so an implementing PR edits the record and not the README. No file is renamed or renumbered and no record's body changes. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Wayland Yang <wayland0916@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
docs/design/README.mdkept a third table of records that stopped at 0045.Change
Proposed,Accepted,In progress,Implemented,Superseded by NNNN, then the date and PR, thenopen:and what is not built. The longest is 199 characters.Status history(48 records).Not changed
No file is renamed, moved or renumbered, and no record's body changes. The roughly 1,200 references to record numbers in code comments and the links between records all still resolve.
Three statuses were brought up to date while rewriting them: 0054 (cut 1 landed in #884), 0062 (landed in #922) and 0063 (landed as #969).
Verification
A script checked every relative link in
docs/decisionsanddocs/design. Two links in 0054 were already broken on dev (0001-extraction.md,0022-a-fact-has-two-clocks.md) and are left for a separate fix.🤖 Generated with Claude Code