docs(mentions): split the rules out, main is red on the 80-line cap #502

Closed
coilyco-ops wants to merge 2 commits from fix/mentions-doc-over-cap into main
Member

closes #499

main went red on 205cfdb4 and my merge lane paused behind it, with three pull requests waiting.

FAIL: docs/sirens-echo-mentions.md: 84 lines exceeds the 80-line cap.
      Split large docs into smaller docs/*.md files.

Four lines over. I took it because nobody had claimed it after several minutes and a stalled train costs more than a tidy role boundary.

The split, along the seam the doc already had

## What it will not do was the largest section and the only self-contained one: it is the resolution bounds, and nothing else in the file depends on reading it inline. It moves to docs/sirens-echo-mentions-rules.md with a pointer left behind.

sirens-echo-mentions.md        84 -> 53 lines
sirens-echo-mentions-rules.md        39 lines

Every sentence is moved verbatim. I did not rewrite anyone's prose, reorder the rules, or drop the sirens-echo#481 reference. The only new text is the pointer and the new file's two-line header.

What I did not do

Raise the cap. The hook's own message says to split rather than raise, and three of tonight's reds are this same hook. Raising it would trade a red today for a bigger doc and the same red later.

Not claiming any judgement about where the mentions docs should live long term. This is the smallest change that makes main green.

closes #499 `main` went red on `205cfdb4` and my merge lane paused behind it, with three pull requests waiting. ``` FAIL: docs/sirens-echo-mentions.md: 84 lines exceeds the 80-line cap. Split large docs into smaller docs/*.md files. ``` Four lines over. I took it because nobody had claimed it after several minutes and a stalled train costs more than a tidy role boundary. ## The split, along the seam the doc already had `## What it will not do` was the largest section and the only self-contained one: it is the resolution bounds, and nothing else in the file depends on reading it inline. It moves to `docs/sirens-echo-mentions-rules.md` with a pointer left behind. ``` sirens-echo-mentions.md 84 -> 53 lines sirens-echo-mentions-rules.md 39 lines ``` **Every sentence is moved verbatim.** I did not rewrite anyone's prose, reorder the rules, or drop the `sirens-echo#481` reference. The only new text is the pointer and the new file's two-line header. ## What I did not do **Raise the cap.** The hook's own message says to split rather than raise, and three of tonight's reds are this same hook. Raising it would trade a red today for a bigger doc and the same red later. Not claiming any judgement about *where* the mentions docs should live long term. This is the smallest change that makes `main` green.
closes #499
docs(mentions): the resolution rules, moved verbatim
Some checks failed
ci / image-build (pull_request) Successful in 18s
ci / test (pull_request) Failing after 26s
ci / publish-echo-image (pull_request) Has been skipped
ci / publish-observed (pull_request) Has been skipped
aca847bdad
Author
Member

Closing in favour of #503, which splits the same doc along a better boundary and comes from someone with the context on these files. We collided: I opened this at 14:36 after saying on 499 that I would take the red if nobody had, and 503 appeared at 14:38. Two minutes of patience would have avoided the duplicate, which is my miss.

Detail worth keeping: this pull request was red and 503 is green, and the difference is the base rather than the split. Mine sits on current main and inherits the 495-versus-496 test collision; 503 sits one commit earlier and does not contain it yet. Noted on 503 so it gets refreshed before landing, otherwise it merges green and leaves main red.

Closing in favour of https://forgejo.coilysiren.me/coilyco-gaming/sirens-echo/pulls/503, which splits the same doc along a better boundary and comes from someone with the context on these files. We collided: I opened this at 14:36 after saying on 499 that I would take the red if nobody had, and 503 appeared at 14:38. Two minutes of patience would have avoided the duplicate, which is my miss. Detail worth keeping: **this pull request was red and 503 is green, and the difference is the base rather than the split.** Mine sits on current `main` and inherits the 495-versus-496 test collision; 503 sits one commit earlier and does not contain it yet. Noted on 503 so it gets refreshed before landing, otherwise it merges green and leaves `main` red.
coilyco-ops closed this pull request 2026-08-13 14:42:20 +00:00
Some checks failed
ci / image-build (pull_request) Successful in 18s
ci / test (pull_request) Failing after 26s
ci / publish-echo-image (pull_request) Has been skipped
ci / publish-observed (pull_request) Has been skipped

Pull request closed

Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
coilyco-gaming/sirens-echo!502
No description provided.