fix(docs): repair broken internal links across en/zh#12
Merged
Conversation
OneVth
force-pushed
the
fix/broken-internal-links
branch
from
July 9, 2026 12:01
9f5174f to
362274a
Compare
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.
I hit a 404 while translating the Korean docs, so I checked the rest of the internal links across all three languages and found a lot more broken ones.
Most of them broke in the 2.0 restructure: editor pages moved under
colors/,typography/, andworkspace-components/, but the links pointing to them were never updated. Separately, a lot of thecallout-metadatacross-links were already off by one directory level. The page URLs have a trailing slash, so../sibling/page-Nresolves under the current page instead of next to it.This PR fixes the en and zh docs. The Korean side is handled separately in the full ko 2.0 update, since ko is being restructured there at the same time. Keeping ko out of this PR avoids overlapping edits between the two.
What's broken (live site)
Each of these links leads to a 404 because the target page moved during the restructure. It's the same 404 page in every case, shown here paired with the page the link is on.
What changed
callout-metadatasibling cross-links and a few other links that were resolving one level short.Only link paths were changed. No translated text was touched (verified via word-diff). 186 files, +282/−282 (en and zh).
After the fix (local build)
Same two links now resolve to the correct pages: