Stabilize 2.7.1 website docs#1123
Open
Aias00 wants to merge 1 commit into
Open
Conversation
The website now treats 2.7.1 as current and keeps 2.7.0.3 in the historical version list. Current docs, zh i18n, blog routing warnings, and historical broken links were updated so the production build is clean while preserving legacy namepsace URLs. Constraint: Docusaurus static hosting does not provide server-side redirects without extra redirect configuration Rejected: Add a redirects plugin | would introduce a new dependency for one legacy typo URL Rejected: Keep namepsace as an unlisted docs page | Docusaurus still included it in generated sidebars Confidence: medium Scope-risk: broad Directive: Keep the static namepsace compatibility page out of docs content; it must not reappear in generated sidebars Tested: COREPACK_ENABLE_PROJECT_SPEC=0 yarn build Tested: grep build log for broken links, broken anchors, duplicate routes, blog metadata warnings, and zh plural warnings Tested: Verified /docs/user-guide/admin-usage/namepsace and /zh/docs/user-guide/admin-usage/namepsace return 200 and target the corrected namespace routes Not-tested: Full manual copy review for every historical-version document touched by mechanical link and anchor normalization
Aias00
force-pushed
the
docs/refresh-2.7.1-site
branch
from
3373e22 to
af760b7
Compare
yu199195
approved these changes
Jun 9, 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
namepsaceURLs with a static compatibility page while keeping the typo out of generated docs sidebarsReview notes
namepsacecompatibility is client-side static redirection, not an HTTP 301/302, because the site currently has no redirect plugin or server redirect layersrc/pages/versions.tsxstill has a hardcoded current version label that can drift if future version metadata changes are not kept in syncVerification
COREPACK_ENABLE_PROJECT_SPEC=0 yarn build/docs/user-guide/admin-usage/namepsace,/docs/user-guide/admin-usage/namespace,/zh/docs/user-guide/admin-usage/namepsace, and/zh/docs/user-guide/admin-usage/namespacenamepsaceno longer appears in current docs sidebarNot tested