docs(release): backport release-line docs refresh#460
Merged
Conversation
15 tasks
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
Backports #458 to
release-0.2so future0.2.xpatch releases can refresh the existing0.2.xdocs snapshot instead of publishing stale release-line docs.This keeps the
0.2.xversioned docs aligned with the plugin behavior shipped in0.2.1, keeps release-line labels in the docs version dropdown, and adds the release-branch CI guard that requires matching versioned-docs updates when source docs change onrelease-*branches.Related Issues
Backports #458.
Related to the
0.2.1release follow-up.Type of Change
Risk and Compatibility
Low runtime risk; this only changes docs, docs tooling, and CI routing on the
release-0.2branch. Public docs paths remain stable. The refresh command intentionally uses the checked-out branch docs, so0.2.xsnapshots can be refreshed fromrelease-0.2without pulling inmainor future0.3.xdocs.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 buildnpm --prefix website run test:e2egit diff --check origin/release-0.2...HEADmake lint-ciReviewer Notes
This PR also fixes the refresh script behavior for the transient state where
0.2.0is temporarily removed fromversions.jsonwhile the snapshot is rebuilt. The Docusaurus version labels are now only applied for versions currently present inversions.json.Checklist