Skip to content

docs(adr): remove stale slugs from _order.txt (renumber leftovers)#59

Merged
lusoris merged 1 commit into
masterfrom
chore/adr-order-cleanup-20260528
May 28, 2026
Merged

docs(adr): remove stale slugs from _order.txt (renumber leftovers)#59
lusoris merged 1 commit into
masterfrom
chore/adr-order-cleanup-20260528

Conversation

@lusoris
Copy link
Copy Markdown
Contributor

@lusoris lusoris commented May 28, 2026

Summary

  • Remove 0452-vif-scratch-buf-hoist-to-vifstate and 0460-ms-ssim-enable-db-clip-db-gpu-parity from _order.txt (stale slugs left over from ADR renumbering to 0578/0582).
  • Delete the two duplicate fragment files (confirmed: wrong ADR number in table link, otherwise content matches).
  • Fix 0578 fragment: internal link was 0452-vif-scratch-buf-hoist-to-vifstate.md; corrected to 0578-vif-scratch-buf-hoist-to-vifstate.md.
  • Create missing 0582-ms-ssim-enable-db-clip-db-gpu-parity.md fragment.
  • Regenerate docs/adr/README.md — no more duplicate/stale rows.

Reproducer

grep '0452\|0460' docs/adr/_index_fragments/_order.txt
# was: 0460-ms-ssim-enable-db-clip-db-gpu-parity and 0452-vif-scratch-buf-hoist-to-vifstate
# after: (empty)
grep '0578\|0582' docs/adr/_index_fragments/_order.txt
# 0582-ms-ssim-enable-db-clip-db-gpu-parity, 0578-vif-scratch-buf-hoist-to-vifstate
scripts/docs/concat-adr-index.sh --check && echo OK

Deep-dive deliverables checklist

  • research digest: no digest needed: mechanical doc-index cleanup
  • decision matrix: no alternatives: only-one-way fix
  • AGENTS.md invariant: no rebase-sensitive invariants
  • reproducer / smoke-test: greps above + concat-adr-index.sh --check
  • changelog fragment: changelog.d/fixed/adr-order-cleanup.md
  • rebase-notes entry: ADR renumber stale slugs in _order.txt should be removed on renumber

Per-surface docs

no user-discoverable surface changed: internal doc-index maintenance only

state.md

no bug opened or closed; no state.md update needed

🤖 Generated with Claude Code

@lusoris lusoris enabled auto-merge (squash) May 28, 2026 17:51
@lusoris lusoris force-pushed the chore/adr-order-cleanup-20260528 branch from 2be5899 to b476ef1 Compare May 28, 2026 19:37
Two ADRs were renumbered after initial registration: the vif-scratch-buf
hoist moved from 0452 to 0578, and ms-ssim enable_db/clip_db parity moved
from 0460 to 0582. The old slugs were never removed from _order.txt, and
no fragment files were created for the new numbers, causing the README to
carry duplicate or stale rows.

- Remove 0452-vif-scratch-buf-hoist-to-vifstate and
  0460-ms-ssim-enable-db-clip-db-gpu-parity from _order.txt; replace with
  0578 and 0582 slugs respectively.
- Delete the two stale fragment files (confirmed duplicates with wrong
  ADR number in the link).
- Fix 0578 fragment: internal link pointed to 0452-*.md; corrected to
  0578-*.md.
- Create 0582-ms-ssim-enable-db-clip-db-gpu-parity.md fragment (was
  missing entirely).
- Regenerate docs/adr/README.md (no stale 0452/0460-ms rows remain).
- Add rebase-notes entry: renumbered slugs must be updated in _order.txt.

no digest needed: mechanical doc-index cleanup
no decision matrix needed: only-one-way fix
no rebase-sensitive invariants

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@lusoris lusoris force-pushed the chore/adr-order-cleanup-20260528 branch from b476ef1 to d600a3b Compare May 28, 2026 21:55
@lusoris lusoris merged commit 6f107df into master May 28, 2026
1 of 20 checks passed
@lusoris lusoris deleted the chore/adr-order-cleanup-20260528 branch May 28, 2026 22:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant