docs(release): support release-line docs refresh#458
Merged
Conversation
Signed-off-by: Roel de Cort <roel.decort@adfinis.com>
Signed-off-by: Roel de Cort <roel.decort@adfinis.com>
This was referenced May 19, 2026
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.
Summary
Adds the missing release-line docs workflow for patch releases. Patch releases still reuse the existing
X.Y.0Docusaurus version, but docs fixes that apply to a patch release can now refresh that existing release-line snapshot withmake docs-refresh-version DOCS_VERSION=X.Y.0.This also updates the
0.2.xversioned docs with the plugin behavior shipped in0.2.1, labels release-line docs as0.2.xand0.1.xin the version dropdown, and adds a CI guard for PRs targetingrelease-*branches that change source docs without touching the matching versioned snapshot.Related Issues
Related to the
0.2.1release follow-up and #395.Type of Change
Risk and Compatibility
Low runtime risk; this only changes docs, docs tooling, and CI routing. The public docs paths remain stable:
0.2.xstill serves from/docs, and0.1.xstill serves from/docs/0.1.0. Only the visible version labels change to represent release lines rather than exact patch versions.Verification
node --check website/scripts/snapshot-version.mjs && node --check website/scripts/refresh-version.mjs./bin/actionlint .github/workflows/*.ymlnpm --prefix website run typecheckwebsite/scripts/refresh-version.mjs 0.2.0, verifyingversions.jsonorder stays0.2.0,0.1.0npm --prefix website run buildnpx --prefix website playwright install chromiumnpm --prefix website run test:e2egit diff --checkmake lint-ciReviewer Notes
The refresh command intentionally uses the currently checked-out docs as the source. For patch releases, run it from the relevant release branch, not from
main, so0.3.0-only docs do not leak into the0.2.xsnapshot.Checklist