docs: remove the JustDummies records this repository no longer owns - #412
Merged
Conversation
The documentation half of ADR-0069, after the code left in the previous change. Removed: the 33 ADRs the renumbering table marks 'moved' (66 files with their translations), the 28 JD analyzer pages (56 files), and the dated JustDummies architecture audit. ADR-0069 keeps ADR-0006, ADR-0011, ADR-0026 and ADR-0061: they record decisions THIS repository made, and FirstClassErrors.Testing's shape is unreadable without them. The 'moved' versus 'adopted' column of that table is the criterion, not a text search. Nine ADRs are adopted — live in both repositories — and stay; ADR-0048 'Guarantee a generated regex value matches its pattern' does not contain the word 'dummies' anywhere and is entirely about JustDummies. A grep would have kept it and dropped the mutation-gate decisions. Links, not just files: every markdown link from a surviving page to a removed ADR now points at its renumbered file in Reefact/just-dummies. Replacing a record with a dead link is worse than either. The index reconciles exactly — 35 rows, 35 files, no orphan in either direction. The dated 2026-07-20 audit is the one place left untouched: it mentions removed ADRs in prose, carries no link to them, and rewriting a dated finding would falsify it. Only its one link to the JustDummies audit is repointed. AddingAReleaseTrain gains a 'Removing a train' section, in both languages, because removing the dum train taught something the checklist did not know: a workflow that publishes a REQUIRED status check leaves the requirement behind when it is deleted, and every later pull request then sits at blocked with every check green. It cost this migration one debugging round. Refs: #404
Reefact
force-pushed
the
claude/french-responses-fbdmo6
branch
from
August 7, 2026 21:28
a2ac826 to
c558ce7
Compare
Reefact
enabled auto-merge (rebase)
August 7, 2026 21:29
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
2 participants
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.
Summary
The documentation half of ADR-0069, after the code left in #411. 149 files. The tag
archive/justdummies-adrmarks the last commit carrying these records.Type of change
What was removed, and how the set was chosen
The criterion is the
moved/adoptedcolumn of the renumbering table injust-dummiesADR-0045 — not a text search.movedmeans the decision left with its code;adoptedmeans it is live in both repositories. Nine adopted ADRs stay.That distinction is load-bearing: ADR-0048 "Guarantee a generated regex value matches its pattern" does not contain the word "dummies" anywhere and is entirely about JustDummies, while several mutation-gate ADRs mention it constantly and are FirstClassErrors decisions. A grep would have kept the first and dropped the others.
Four ADRs are kept although they concern JustDummies, as ADR-0069 requires: ADR-0006, ADR-0011, ADR-0026, ADR-0061. They record decisions this repository made, and
FirstClassErrors.Testing's current shape is unreadable without them.Links, not just files
Every markdown link from a surviving page to a removed ADR now points at its renumbered file in
Reefact/just-dummies— 16 files repointed. Replacing a record with a dead link would be worse than either.Verified with a link checker over every relative
.mdlink in the repository: 1 dead link left, and it predates this change —ADR-0024's French page links toadr/README.fr.md, which has never existed in any commit. Left alone deliberately: editing an accepted ADR in place is not mine to do.The index reconciles exactly: 35 rows, 35 files, no orphan in either direction. That check also caught a duplicated row in the original index (69 rows for 68 ADRs).
One place deliberately untouched
The dated
2026-07-20FirstClassErrors audit mentions removed ADRs in prose, with no links to them. Rewriting a dated finding would falsify it, so its text stands. Only its single link to the JustDummies audit is repointed at the other repository.A section the checklist did not have
AddingAReleaseTrain.{en,fr}.mdgains "Removing a train", because #411 taught something the runbook did not know: a workflow that publishes a required status check leaves that requirement behind when deleted, and every later pull request then sits atmergeable_state: blockedwith every check green — a state that reads as a content problem and is not one. It cost this migration one debugging round. The section also states plainly that dropping a requirement for code the repository no longer contains is not a weakened protection.Testing
dotnet build FirstClassErrors.sln— 0 warnings, 0 errorsdotnet test FirstClassErrors.sln— 0 failuresDocumentation
doc/updatedAddingAReleaseTrainJDxxxpages are gone; the publishedJustDummiesanalyzers'HelpLinkUrialready points atjust-dummies, verified in itsHelpLinks.cs, so no live help link breaks.Architecture decisions
AcceptedADR-0069.Related issues
Refs #404 — this completes the cutover it tracks.
Generated by Claude Code