Commit bd5d66a
committed
docs(deployment): reconcile the gate section with the four doors, the real rule count and the retired alias rule (#7465)
Three drifts between `validating-metadata.mdx` and `cli.mdx`, fixed in one
commit because the first of them cannot be fixed in one file.
1. `## The one gate, three entry points` → `## The one gate, four doors`.
Since #4463 P1 the table has four columns: the three CLI commands plus the
runtime publish gate. "Entry points" cannot absorb the fourth — the section's
own prose says that door "is not a command" — so the noun the section already
uses for the superset ("There is a fourth door") becomes the heading.
The rename is a three-site coordinated edit: heading, anchor fragment and
link text. `cli.mdx:458` carried all of the last two, so it moves in the same
commit; renaming the heading alone would have left a dead fragment and a link
whose text contradicted its destination. Repo-wide grep for the old anchor
and the old phrase found exactly these two sites.
2. The quoted `os validate` transcript read `Running author-time rules (26)`.
That line prints `authoringRulesFor('validate').length`, measured at 38 by
executing the registry — not the 26 of the #4409-era audit. The neighbouring
"23 of 26 rules" sentence is a statement about that historical audit and is
deliberately left alone.
3. `cli.mdx` still advertised `deprecated visibility aliases` among `os lint`'s
advisories. `visibility-alias-deprecated` was retired by #6318; every
remaining mention in the tree is commentary about the retirement, a test
pinning it, a CHANGELOG entry or the changeset. The docs promised a lint
output that can never appear, so the item is dropped.
Fixes #7465
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019qshjWWLkvNTRTSyoj8KdQ1 parent a76a3af commit bd5d66a
2 files changed
Lines changed: 4 additions & 5 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
455 | 455 | | |
456 | 456 | | |
457 | 457 | | |
458 | | - | |
| 458 | + | |
459 | 459 | | |
460 | 460 | | |
461 | 461 | | |
| |||
469 | 469 | | |
470 | 470 | | |
471 | 471 | | |
472 | | - | |
473 | | - | |
| 472 | + | |
474 | 473 | | |
475 | 474 | | |
476 | 475 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
346 | 346 | | |
347 | 347 | | |
348 | 348 | | |
349 | | - | |
| 349 | + | |
350 | 350 | | |
351 | 351 | | |
352 | 352 | | |
| |||
479 | 479 | | |
480 | 480 | | |
481 | 481 | | |
482 | | - | |
| 482 | + | |
483 | 483 | | |
484 | 484 | | |
485 | 485 | | |
| |||
0 commit comments