Repository navigation
Commit f7d6f5b
docs(releases): the 18.1.0 notes, and the 18.x level rule on every page that still promised strict SemVer after GA (#25460)
<!-- claude-projects-attribution: {"github_login":"marchtian"} -->
_Requested by **田騏** · [project
thread](https://claude.ai/code/project/chan_01VmuUhXU9SSUzqJYyXSmYSi?thread=cmsg_01VmuUhXU9SSUzqJYyXSmYSiRwWtsarkLPmw9fMYiFZ3LY)_
Clause-②: no
Metadata-protocol: none
A docs-only PR (`content/docs/**` plus the docs-audit list). It
publishes nothing from any released package, so it carries no changeset.
It does not touch the Version Packages PR #24876, and it performs no
release act.
## Why
I audited the 18.0 and 18.1 release docs against what shipped and what
is pending:
- **18.0.0.** `releases/v18/18-0.mdx` is still accurate. `npm view` on
2026-10-23 reads `latest` = 18.0.0 and `next` = 18.0.0-next.5. Two pages
around it had drifted:
- **Upgrading → "Upgrading to 18.0"** describes three behaviours that
only exist on `main` and gives them no version: #25155 (`--no-server` is
no longer a way round the auth refusal), #25231 (a plugin-auth load
failure is refused) and #25179 (`os migrate plan` lists nullable tenant
columns). A reader on 18.0.0 is told about refusals that 18.0.0 does not
make.
- **Versioning policy.** Backward Compatibility says "the window closes
at GA, and strict SemVer resumes from that point", and that a PATCH has
"no behavior changes". The releases index says "A patch release fixes
bugs." Ruling A (#25105, 2026-10-21) keeps the no-major guard and grades
by the metadata protocol, so after 18.0.0 a non-protocol breaking change
ships as `patch`. 18.1.0 is a minor that carries 82 changesets declared
breaking, 37 of them graded `patch`, #25399 among them. A `^18.0.0`
range takes it unattended.
- **18.1.0.** No page existed. I rehearsed `pnpm run version` in a
throwaway clone of `main` (`2581efb`). It produces 18.1.0 across 73
packages with 227 distinct CHANGELOG entries. Every content gate the
publish lane runs is green on that tree. The one exception is
`check-release-section-coverage`, which is advisory: "NO heading on this
page names the 18.1 series".
- **ADR-0087.** The registry is complete. `check-adr-0087-registration
--list` shows 82 declared-breaking changesets, all 82 with a disposition
and 0 residue: 9 `registered`, 7 `already-registered`, 61
`no-migration-prescription`, 4 `runtime-export-retired` and 1
`runtime-interface-only`. `check:upgrade-guide` and `check:spec-changes`
both generate cleanly.
## What changes
- **`releases/v18/18-1.mdx` (new).** The 18.1.0 notes, compiled from the
changesets, with the entries grouped by `classifyReleaseBullet` as the
GitHub Release body groups them:
- 73 entries need action from the reader, 9 are converted, 41 are new
capabilities, 0 are semantic and 104 are fixes.
- The page adds a Console section (pin `616df6598b42` → `1d178e06ac5e`,
six refreshes, 91 objectui entries) and an upgrade checklist from
18.0.0.
- Two callouts say the page was compiled before the cut and has not been
walked.
- The cloud-managed break (#25399) gets its own section, which says
self-hosted deployments are unchanged.
- **`upgrading.mdx`.**
- The three post-18.0.0 behaviours now say "from 18.1.0".
- The per-release table gains a 18.1.0 row.
- The sentence "a minor has nothing for `os migrate meta` to replay" now
notes the nine step-18 conversions that 18.1.0 adds.
- **`protocol/backward-compatibility.mdx`, `releases/index.mdx`,
`releases/v18/index.mdx`.** These now state the post-GA level rule. The
v18 index also links 18.1.0 and notes the 18.1.0 tightening of the
auth-secret refusal.
- **`releases/v18/18-0.mdx`.** It now says that a caret range takes
later 18.x releases, which can break, and section 4 points at the 18.1.0
notes.
- **`scripts/docs-audit/handwritten-docs.json`.** This regenerates with
`--write` for the new page.
The "current series" field on the releases index is left to
`sync-release-index-currency.mjs`. On the rehearsed post-version tree it
stamps `18.1.0`, and `check:release-notes`, `check:release-page-status`,
`check:doc-anchors` and the section-coverage check are all green.
## Follow-up after the publish
These are not in this PR:
- A "Release facts, as measured" section, filled in with `npm view`
after the publish.
- A walked 18.0.0 → 18.1.0 checklist, which replaces the "not walked"
callouts.
## Verified locally
- `check:doc-anchors`, `check:docs-single-h1`, `check:docs-redirects`,
`check:docs-audit-scope`, `check:release-notes`,
`check:release-page-status`, `check:release-index-currency-sync`,
`check:published-readme-links` and `check:nul-bytes` are all green.
- An MDX 3 + GFM compile of the six edited pages passes.
---
_Generated by [Claude
Code](https://claude.ai/code/session_01At7xrR4rgknXtej5ZkMJHd)_
Co-authored-by: Claude <noreply@anthropic.com>1 parent 2a80904 commit f7d6f5b
8 files changed
Lines changed: 610 additions & 29 deletions
File tree
- content/docs
- protocol
- releases
- v18
- scripts/docs-audit
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
| 21 | + | |
| 22 | + | |
21 | 23 | | |
22 | 24 | | |
23 | 25 | | |
24 | 26 | | |
25 | 27 | | |
26 | 28 | | |
27 | 29 | | |
28 | | - | |
29 | | - | |
| 30 | + | |
| 31 | + | |
30 | 32 | | |
31 | 33 | | |
32 | 34 | | |
| |||
201 | 203 | | |
202 | 204 | | |
203 | 205 | | |
204 | | - | |
| 206 | + | |
205 | 207 | | |
206 | 208 | | |
207 | 209 | | |
208 | 210 | | |
209 | 211 | | |
210 | 212 | | |
211 | | - | |
| 213 | + | |
212 | 214 | | |
213 | 215 | | |
214 | 216 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
64 | 64 | | |
65 | 65 | | |
66 | 66 | | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
67 | 77 | | |
68 | 78 | | |
69 | 79 | | |
| |||
74 | 84 | | |
75 | 85 | | |
76 | 86 | | |
77 | | - | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
78 | 90 | | |
79 | 91 | | |
80 | 92 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
59 | 59 | | |
60 | 60 | | |
61 | 61 | | |
62 | | - | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
63 | 66 | | |
64 | 67 | | |
65 | 68 | | |
| |||
622 | 625 | | |
623 | 626 | | |
624 | 627 | | |
625 | | - | |
| 628 | + | |
| 629 | + | |
626 | 630 | | |
627 | 631 | | |
628 | 632 | | |
| |||
0 commit comments