Skip to content

docs: fix broken anchor links and add migrate-rules to sidebar#2203

Merged
wan9chi merged 2 commits into
voidzero-dev:mainfrom
charpeni:docs-fix-broken-anchors-sidebar
Jul 20, 2026
Merged

docs: fix broken anchor links and add migrate-rules to sidebar#2203
wan9chi merged 2 commits into
voidzero-dev:mainfrom
charpeni:docs-fix-broken-anchors-sidebar

Conversation

@charpeni

@charpeni charpeni commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes four broken internal anchor links in the docs site and adds the previously-orphaned Migration Rules page to the guide sidebar. These surfaced during a proofreading pass over the documentation website.

Changes

Broken anchors — these links resolved to the correct page but silently failed to scroll to the target heading, because the anchor slugs didn't match VitePress's heading slugification (which collapses . and other special characters to -):

  • guide/github-actions-cache.md (2 links): /config/run#tasks/config/run#run-tasks (heading is ## run.tasks)
  • guide/installer-env-vars.md: /guide/env#custom-nodejs-mirror#custom-node-js-mirror
  • guide/installer-env-vars.md: /guide/env#nodejs-signature-verification#node-js-signature-verification

Navigation:

  • Added "Migration Rules" (/guide/migrate-rules) to the guide sidebar, nested under "Migrate to Vite+" (matching the existing Check → Lint/Format nesting). The page previously existed and was reachable only through an inline link in migrate.md, with no sidebar entry.

Correct four internal anchors that pointed at non-existent slugs:
- /config/run#tasks -> #run-tasks
- /guide/env#custom-nodejs-mirror -> #custom-node-js-mirror
- /guide/env#nodejs-signature-verification -> #node-js-signature-verification

Add the Migration Rules page to the guide sidebar (nested under Migrate),
which was previously reachable only via an inline link.
@netlify

netlify Bot commented Jul 19, 2026

Copy link
Copy Markdown

Deploy Preview for viteplus-preview canceled.

Name Link
🔨 Latest commit c158225
🔍 Latest deploy log https://app.netlify.com/projects/viteplus-preview/deploys/6a5dabaebc43710008b27697

@wan9chi wan9chi left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thank you!

@wan9chi
wan9chi merged commit b88cbe7 into voidzero-dev:main Jul 20, 2026
38 of 39 checks passed
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