Skip to content

Chore(Release): v25.4 version of the docs - #763

Merged
matthewmcneely merged 1 commit into
mainfrom
release-v25.4
Aug 17, 2026
Merged

Chore(Release): v25.4 version of the docs#763
matthewmcneely merged 1 commit into
mainfrom
release-v25.4

Conversation

@matthewmcneely

@matthewmcneely matthewmcneely commented Aug 17, 2026

Copy link
Copy Markdown
Collaborator

Cuts the v25.4 documentation version and promotes it to the version served at the site root, matching the v25.4.0 release (2026-07-30).

Summary

  • Snapshots docs/ into docs_versioned_docs/version-v25.4/ and docs-graphql/ into graphql_versioned_docs/version-v25.4/, via docs:version:docs and docs:version:graphql.
  • Sets lastVersion: 'v25.4' on both content plugins, with v25.4 at path '' and v25.3 moved to v25.3.
  • The snapshot carries the Zero --security documentation merged in docs: document Zero --security token and whitelist flags #762, the one user-facing change in v25.4.0.

Also in here: a graphql version-map repair

Worth a look, since it is easy to miss in a 227-file diff. The v25.3 cut (b75fd1a) added "v25.3" to graphql_versions.json but never added a matching entry to the graphql plugin's versions map in docusaurus.config.ts. Docusaurus fell back to defaults for it, so /graphql/ kept serving v25.2 (latest) while v25.3 sat above it in the dropdown as an older version. Both v25.3 and v25.4 now have explicit entries, and the GraphQL section moves from v25.2 to v25.4 as latest.

URL movement

Normal for any cut, but the GraphQL section advances two versions at once:

Path Before After
/<page> v25.3 v25.4
/v25.3/<page> 404 v25.3
/graphql/<page> v25.2 v25.4
/graphql/v25.2/<page> 404 v25.2
/graphql/v25.3/<page> v25.3 v25.3 (unchanged)

Testing

npm run build passes. With onBrokenLinks: 'throw', a clean build is the link check across all five versions. Verified against the generated output in build/:

  • / and /graphql/ both render v25.4 (latest), with v25.3, v25.2, v25.1, and v24.1 in the dropdown.
  • /cli/zero and /admin/security/admin-endpoint-security include the --security content; /v25.3/ equivalents do not, since the flag is in no v25.3.x binary.
  • All eight older-version paths resolve.

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Cut a version and update the selector config.

Snapshots docs/ and docs-graphql/ into version-v25.4 and promotes v25.4
to the version served at the site root. The snapshot carries the Zero
--security documentation from #762.

Also repairs the graphql plugin's version map. The v25.3 cut added
"v25.3" to graphql_versions.json but never added a matching entry to
docusaurus.config.ts, so /graphql/ kept serving v25.2 as latest while
v25.3 appeared in the dropdown as an older version. Both v25.3 and v25.4
now have explicit entries.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@matthewmcneely
matthewmcneely merged commit 7dd62e1 into main Aug 17, 2026
1 check passed
@matthewmcneely
matthewmcneely deleted the release-v25.4 branch August 17, 2026 20:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant