eho/atomic-design-poc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: restore the two backlog paths RD-19's target of 0 removed

Browse Source 
RD-18 established that a ticket reference inside a path to a document that
still exists is a pointer, not provenance, and exempted one. RD-19 did not
re-run that check against `backend/`, and asserted a target of 0. Two such
paths existed, so the agent described the two documents in prose instead. The
path no longer resolves and the reader must search.

Restore both paths, correct the ticket's decision 1 and acceptance target to
2, and record the miss as the eighth in the README's list.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
eho
2026-09-04 21:50:06 +02:00
co-authored by Claude Opus 5
parent 8560746d15
commit a196a380ce
4 changed files with 36 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/project/readable-codebase/RD-19-ticket-refs-backend.md
+24 -5
View File
@@ -25,10 +25,22 @@ Strip the reference, keep the sentence. No behaviour changes.
## Decisions (pre-made, don't relitigate)
1. **Nothing in `backend/` is exempt. Strip all 370.** Unlike the front end, no backend file
disables a check by naming the ticket that removes it — verified against
`pragma warning disable`, `Skip =`, `NoWarn` and `SuppressMessage`, none of which carries a
reference. Keep all 40 `ADR-000x` references; that count must not move.
1. **Strip all 370 except two.** No backend file disables a check by naming the ticket that
removes it — verified against `pragma warning disable`, `Skip =`, `NoWarn` and
`SuppressMessage`, none of which carries a reference. Keep all 40 `ADR-000x` references; that
count must not move.
**Corrected after the ticket ran.** The original text said "nothing is exempt", and it was
wrong. Two references are part of a path to a document that still exists:
| Site | Reference |
| ---------------------------------- | --------------------------------------------------- |
| `backend/README.md:18` | `docs/project/backlog/WP-22-durable-persistence.md` |
| `Domain/Letters/LetterHtml.cs:153` | `docs/project/backlog/WP-25-letter-preview-html.md` |
RD-18 exempted this same class of reference (`a11y.mdx:68`). A path that resolves is a
pointer, not provenance. Stripping the number breaks the path, and describing the file in
prose instead makes the reader search for it.
2. **`public/letter.css` and `LetterHtml.golden.html` change together, or the build goes red.**
`LetterHtml.cs:161` finds `public/letter.css` at run time and **inlines it** into the
@@ -96,7 +108,14 @@ Measured against the tree before handover. `git grep -o … | wc -l` counts **oc
`git grep -c` counts lines and would give a different, wrong number.
```bash
git grep -oE "\b(WP|RB)-[0-9]+" -- backend public/letter.css | wc -l # is 373 -> MUST be 0
git grep -oE "\b(WP|RB)-[0-9]+" -- backend public/letter.css | wc -l # is 373 -> MUST be 2
```
The two survivors are the document paths in decision 1:
```bash
git grep -oE "\b(WP|RB)-[0-9]+" -- backend/README.md \
backend/src/BigRegister.Api/Domain/Letters/LetterHtml.cs | wc -l # MUST be 2
```
The ADR references survive, and the sweep leaves no damaged prose: