docs: collapse duplicate REQ rows (REQ-1003/1200, REQ-1204/407) #389

Closed

opened 2026-09-25 00:48:15 +09:00 by natsukium · 1 comment

natsukium commented

2026-09-25 00:48:15 +09:00

Owner

docs/reference/spec.md has two pairs of requirement rows that state the same requirement:

REQ-1003 and REQ-1200 state the same requirement with the same sources.
REQ-1204 restates REQ-407. The docs consistency audit scoped both to "while every sized run still fits".

Two IDs for one requirement drift independently: every fix has to find both rows. Decide whether to keep one ID per requirement and turn the other into a pointer (or retire it), and how retired IDs are marked so that external references stay resolvable.

`docs/reference/spec.md` has two pairs of requirement rows that state the same requirement: - REQ-1003 and REQ-1200 state the same requirement with the same sources. - REQ-1204 restates REQ-407. The docs consistency audit scoped both to "while every sized run still fits". Two IDs for one requirement drift independently: every fix has to find both rows. Decide whether to keep one ID per requirement and turn the other into a pointer (or retire it), and how retired IDs are marked so that external references stay resolvable.

natsukium added the

type/design

label

2026-09-25 00:48:15 +09:00

natsukium referenced this issue

2026-09-25 00:48:41 +09:00

docs: fix inconsistencies found by a tree-wide docs and skills audit #395

natsukium referenced this issue from a commit

2026-09-25 00:54:55 +09:00

docs: fix inconsistencies found by a tree-wide docs and skills audit (#395)

natsukium commented

2026-09-25 11:45:18 +09:00

Author

Owner

Decision: keep one ID per requirement and delete the duplicate rows outright, with no pointer row left behind. Repoint every in-repo reference to the surviving ID (grep docs/, skills, code comments, tests).

natsukium referenced this issue from a pull request that will close it,

2026-09-25 11:49:56 +09:00

docs: keep one requirement ID per requirement #435

natsukium closed this issue

2026-09-25 12:29:51 +09:00

natsukium referenced this issue from a commit

2026-09-25 12:29:52 +09:00

docs: keep one requirement ID per requirement (#435)

Commenting is not possible because the repository is archived.