Benefits and Costs are two blocks now, and five sections never had a benefit half - #40
Merged
Merged
Conversation
…elivered The third BLUF slot was "What it costs you" and asked for one thing: the price of adopting the document. It is now "Cost/Benefit" and asks for two, so the eleven blocks under it were REWRITTEN rather than relabelled. Relabelling alone would have left every page naming a benefit in the label and delivering only a cost in the prose -- the drift PD-10 exists to stop, arriving by a new route, and no gate here can see it, because PD-4 is why the prose inside a block is not checked. The vocabulary is pinned in two places and both moved together: PD-10's row in HOUSE-STYLE.md and BLUF_SLOTS in tests/test_docs_do_not_drift.py. The both-halves requirement is recorded as prose rather than folded into the enforced row, since it is not enforceable and claiming enforcement it does not have is the defect this set exists to catch. Six H2 sections were renamed to match. The anchors made that less mechanical than it looks: the slug rule deletes characters outside [\w\s-] rather than replacing them, so the slash vanishes and "Cost/Benefit, and where it does not apply" anchors as #costbenefit-and-where-it-does-not-apply. Five inbound links follow it. CI-ENFORCEMENT's section loses no clause because it was already both-sided; OVERVIEW's "What each one buys you" is a cross-document comparison and stays. Two sentences broke in the rename and were rewritten rather than left standing. REVIEW-DEPTH and AI-ASSISTED-DEVELOPMENT each ended up a block labelled Cost/Benefit linking to a section of the same name, and REVIEW-DEPTH's had collapsed to "Cost/Benefit is explicit.", which says nothing. Link text now carries meaning standing alone, which matters more than it looks: pandoc renders a link as bare text in the .docx, so a Word reader gets the words or nothing. The long-sentence ratchet then caught the fix -- descriptive link text pushed one sentence to 35 words, 220 against a baseline of 219. Split at its semicolon rather than raising the baseline. Ten Word copies regenerated on pandoc 3.10, the pinned version. Suite green at 146. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The BLUF slot splits again, from "Cost/Benefit" into "Benefits" then "Costs". Benefits leads, which inverts the order this set used before. The objection is recorded in HOUSE-STYLE and in the BLUF_SLOTS comment rather than answered: benefit-then-price is the shape of a pitch followed by fine print, and this corpus is built to read as the opposite. What holds it honest is that "Not for you" still follows both, and that Costs keeps every concrete price the combined block named -- a split is not permission to soften the half that was harder to write. Eleven blocks became twenty-two, with the connectives that joined them rebuilt at the source rather than carried across the cut, so neither block opens on a dangling pointer to the other. THE SECTION SPLIT IS NOT UNIFORM, AND THAT IS THE FINDING. Six body sections carried the retired heading. Only CI-ENFORCEMENT was a cost/benefit section: its nine bullets divide 4/5 on a seam the page already had, so it becomes ## Benefits and ## Costs. The other five -- ASVS-ASSESSMENT, AI-ASSISTED-DEVELOPMENT, CODE-QUALITY, DEPENDENCY-INTEGRITY, REVIEW-DEPTH -- list scope limits with a cost bullet or two among them and contain no benefit material at all: ASVS is five bullets of "no results", "no certification", "no speed claim"; AI-ASSISTED is seven; REVIEW-DEPTH is four. Splitting those would have put a ## Benefits heading over nothing true, so they become ## Costs, and where it does not apply. The earlier rename to Cost/Benefit had already been generous to them. The [external] key in CI-ENFORCEMENT now appears twice, once under each new heading. It documents a notation used twice in the benefits and twice in the costs, so the split leaves no shared place to state it once. That is a real cost of the split and it is duplicated deliberately, not by oversight. Anchors moved a second time: #costs-and-where-it-does-not-apply, plus #benefits and #costs in CI-ENFORCEMENT. Five inbound links repointed, two of them rewritten because a single pointer to the combined section now has two destinations. Ten Word copies regenerated on pandoc 3.10. Suite green at 146. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The third BLUF slot moved twice. It began as What it costs you, asking for the price alone;
became Cost/Benefit, asking for both sides, with the eleven blocks under it rewritten rather
than relabelled; and is now two slots, Benefits then Costs.
BLUF_SLOTSis six strings andPD-10's row moved with it.
Benefits leading inverts the order this set used before, and the objection is recorded in
HOUSE-STYLE and in the
BLUF_SLOTScomment rather than answered. Benefit-then-price is the shape ofa pitch followed by fine print, which is the register this corpus is built against. What holds it
honest is that
Not for youstill follows both, and thatCostskeeps every concrete price thecombined block named.
The section split is not uniform, and that is the finding
Six body sections carried the retired heading. Only
CI-ENFORCEMENTwas a cost/benefit section --its nine bullets divide 4/5 on a seam the page already had -- so it becomes
## Benefitsand## Costs.The other five list scope limits with a cost bullet or two among them and contain no benefit
material at all: ASVS is five bullets of "no results", "no certification", "no speed claim";
AI-ASSISTED is seven; REVIEW-DEPTH is four. A
## Benefitsheading over that would have been aclaim with no receipt, so they become
## Costs, and where it does not apply.Known costs of this change
[external]key in CI-ENFORCEMENT now appears twice, once under each new heading. Itdocuments a notation used twice in the benefits and twice in the costs, and the split leaves no
shared place to state it once. Duplicated deliberately, not by oversight.
Costsblocks gained a sentence or two beyond a pure partition of the oldtext. Each traces to its own document's body and none softens or replaces preserved material,
but the split is not a strict move-only operation.
Verification
.docx, so link text has to carry meaning read on its own.🤖 Generated with Claude Code