Commit 1825f1d
committed
docs(design): fix Claude-bot follow-ups from #701 review
Three issues from the @claude review of PR #701:
1. **Anchor link target now resolves**. The accepted gemini
suggestion added `[follow-ups](#out-of-scope-follow-ups)` to
the P1 status-table row, but the target was a plain-text
paragraph — GitHub only auto-generates anchors for headings,
so the link silently scrolled to the top of the document.
Promoted "Out-of-scope follow-ups" to a `### ` heading and
moved the parenthetical caption onto its own italicised line
below it. Anchor `#out-of-scope-follow-ups` now actually
resolves.
2. **Stale subsection pointer in safety-net doc**. The
2026_04_28_proposed_admin_delete_bucket_safety_net.md
Background section pointed at "Out-of-scope follow-ups" for
the TOCTOU description, but after the rename the TOCTOU is
no longer in that section — it's resolved (described in the
implementation-status block at the top of the implemented
doc, line 23). Updated the prose to say "resolved by this
design and recorded in the implementation-status block of …"
so the cross-link points where the TOCTOU is actually
discussed in the renamed doc.
3. **Stale link description in admin_deployment.md**. The
final cross-references list called the design doc's third
bullet "outstanding items" — that is the `_partial_`-era
wording. Renamed to "out-of-scope follow-ups" to match the
promoted doc's actual section heading.
Also reordered the implementation-status block: TOCTOU
resolution paragraph now precedes the Out-of-scope section so
the doc reads "what shipped → how the late-breaking issue was
fixed → what was deliberately deferred". Previously the
TOCTOU paragraph sat after the deferred-items bullet list
which read awkwardly.
No content changes other than the three fixes above and the
section reorder.1 parent e2ed240 commit 1825f1d
3 files changed
Lines changed: 10 additions & 8 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
403 | 403 | | |
404 | 404 | | |
405 | 405 | | |
406 | | - | |
| 406 | + | |
407 | 407 | | |
408 | 408 | | |
409 | 409 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
17 | | - | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
18 | 22 | | |
19 | 23 | | |
20 | 24 | | |
21 | 25 | | |
22 | 26 | | |
23 | | - | |
24 | | - | |
25 | 27 | | |
26 | 28 | | |
27 | 29 | | |
| |||
Lines changed: 4 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
10 | | - | |
11 | | - | |
12 | | - | |
13 | | - | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
| |||
0 commit comments