Commit 71018fe
committed
docs(check-release-section-coverage): mark the v17 fixture historical, not "actually shipped"
The `REAL_V17_HEADINGS` fixture carried a present-tense docblock — "Kept
verbatim so the matcher is judged against text that actually shipped" — while
the text it snapshots no longer ships. #13754 (merged 2026-08-31) cascaded the
release-page headings: `content/docs/releases/v17.mdx` now reads
`## 17.0.0 in detail`, and no page under `content/docs/releases/` carries a
body-level h1 any more (0 such lines across the ten pages, counter-checked
against 54 `## ` lines in the same files).
The gate is green either way and stays green — `headingsNamingMinor` is
`^#{1,6}`, level-agnostic by construction, and nothing compares the fixture to
the live page. The defect is the claim, not the behaviour: the file already
keeps a deliberately historical snapshot beside it (`PRE_10232_V17_HEADINGS`),
so a reader diffing either against the live page could not tell which was
which.
Relabelled to that sibling's existing convention rather than a third one:
renamed `REAL_V17_HEADINGS` -> `PRE_13754_V17_HEADINGS` (the identifier is the
label a reader meets at the three use sites; the docblock is only visible at
the definition), and the docblock now names what changed and when, as
`PRE_10232_V17_HEADINGS`'s does.
The docblock also carries the reason it must not be re-snapshotted, measured
rather than assumed: a re-snapshot would remove the last h1 that reaches the
matcher through a whole-page fixture, and would remove it in silence — 17.0 is
covered twice over here, so every case in this file stays green with the `# `
demoted to `##`. The matcher's `^#{1,6}` breadth itself is pinned separately by
the `'# 16.1.0'` / `'###### 16.1.0'` case, so the fixture is NOT the only
h1-bearing input and the docblock does not claim to be.
The 17.0 self-test label said the fixture covers 17.0 "via `# 17.0.0 in
detail`", which reads as though the h1 were load-bearing there. Measured: 17.0
matches both `## Highlights — 17.0.0` and `# 17.0.0 in detail`. The label now
says so, and says the case cannot catch a re-snapshot.
No changeset: script-only, publishes nothing from any package — the repo's
precedent (15/15 recent commits touching only `scripts/check-*.mjs`) carries
none. `skip-changeset` applied on the PR.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Pk26oZ12t5N1hwGW1m1MgC1 parent 83ea500 commit 71018fe
1 file changed
Lines changed: 24 additions & 8 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
370 | 370 | | |
371 | 371 | | |
372 | 372 | | |
373 | | - | |
374 | | - | |
| 373 | + | |
| 374 | + | |
| 375 | + | |
| 376 | + | |
| 377 | + | |
| 378 | + | |
| 379 | + | |
| 380 | + | |
| 381 | + | |
| 382 | + | |
| 383 | + | |
| 384 | + | |
| 385 | + | |
| 386 | + | |
| 387 | + | |
| 388 | + | |
| 389 | + | |
375 | 390 | | |
376 | | - | |
| 391 | + | |
377 | 392 | | |
378 | 393 | | |
379 | 394 | | |
| |||
544 | 559 | | |
545 | 560 | | |
546 | 561 | | |
547 | | - | |
548 | | - | |
549 | | - | |
| 562 | + | |
| 563 | + | |
| 564 | + | |
550 | 565 | | |
551 | 566 | | |
552 | | - | |
553 | | - | |
| 567 | + | |
| 568 | + | |
| 569 | + | |
554 | 570 | | |
555 | 571 | | |
556 | 572 | | |
| |||
0 commit comments