Skip to content

fix(docs): repair broken internal links across en/zh#12

Merged
bladeacer merged 1 commit into
flexcyon:stagingfrom
OneVth:fix/broken-internal-links
Jul 10, 2026
Merged

fix(docs): repair broken internal links across en/zh#12
bladeacer merged 1 commit into
flexcyon:stagingfrom
OneVth:fix/broken-internal-links

Conversation

@OneVth

@OneVth OneVth commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

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/, and workspace-components/, but the links pointing to them were never updated. Separately, a lot of the callout-metadata cross-links were already off by one directory level. The page URLs have a trailing slash, so ../sibling/page-N resolves 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.

Link (on this page) Where it lands
image image
image image

What changed

  • Updated links that pointed to old (pre-restructure) editor paths → their new locations.
  • Corrected relative depth on callout-metadata sibling 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:

Link (on this page) Where it lands now
image image
image image

@OneVth
OneVth force-pushed the fix/broken-internal-links branch from 9f5174f to 362274a Compare July 9, 2026 12:01
@OneVth OneVth changed the title fix(docs): repair broken internal links across en/ko/zh fix(docs): repair broken internal links across en/zh Jul 9, 2026

@bladeacer bladeacer left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for raising this, will rebase this and #13 to staging/master when I am free later.

@bladeacer
bladeacer changed the base branch from master to staging July 10, 2026 07:01
@bladeacer
bladeacer merged commit e457985 into flexcyon:staging Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants