Chore(Release): v25.4 version of the docs - #763
Merged
Conversation
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>
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
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.
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
docs/intodocs_versioned_docs/version-v25.4/anddocs-graphql/intographql_versioned_docs/version-v25.4/, viadocs:version:docsanddocs:version:graphql.lastVersion: 'v25.4'on both content plugins, with v25.4 at path''and v25.3 moved tov25.3.--securitydocumentation 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"tographql_versions.jsonbut never added a matching entry to the graphql plugin'sversionsmap indocusaurus.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:
/<page>/v25.3/<page>/graphql/<page>/graphql/v25.2/<page>/graphql/v25.3/<page>Testing
npm run buildpasses. WithonBrokenLinks: 'throw', a clean build is the link check across all five versions. Verified against the generated output inbuild/:/and/graphql/both render v25.4 (latest), with v25.3, v25.2, v25.1, and v24.1 in the dropdown./cli/zeroand/admin/security/admin-endpoint-securityinclude the--securitycontent;/v25.3/equivalents do not, since the flag is in no v25.3.x binary.Need help on this PR? Tag
@codesmith-botwith what you need. Autofix is disabled.