Skip to content

Docs: Fix broken internal links and add sidebar ordering#480

Merged
FL4TLiN3 merged 1 commit intomainfrom
docs/fix-internal-links-and-sidebar-order
Feb 11, 2026
Merged

Docs: Fix broken internal links and add sidebar ordering#480
FL4TLiN3 merged 1 commit intomainfrom
docs/fix-internal-links-and-sidebar-order

Conversation

@FL4TLiN3
Copy link
Contributor

Summary

  • Fix 21 broken internal markdown links across docs
  • Add sidebar: order frontmatter to all doc pages for Starlight navigation
  • Remove obsolete pages that no longer exist (publishing, registry, section READMEs)
  • Fix guide frontmatter format (ordersidebar.order) for Starlight compatibility

Link fixes

  • getting-started/walkthrough.md: 12 links using ./ corrected to ../ for cross-directory references
  • rapid-prototyping.md, experts.md: links to non-existent README.md replaced with actual pages
  • testing.md: removed link to deleted publishing.md
  • README.md: fixed links to getting-started.md, removed refs to non-existent pages

Removed pages

  • docs/getting-started.md (superseded by getting-started/walkthrough.md)
  • docs/making-experts/publishing.md, docs/understanding-perstack/registry.md (features not yet shipped)
  • Section README.md files (replaced by Starlight autogenerate sidebar)

Sidebar ordering

Added sidebar: order to all 27 doc pages for correct navigation order in Starlight.

Test plan

  • bun run build in www app succeeds with no broken link warnings
  • All internal links resolve to existing pages
  • Starlight sidebar shows correct page ordering

🤖 Generated with Claude Code

- Fix walkthrough.md relative links (./ → ../) for cross-directory refs
- Replace links to non-existent README.md files with actual first pages
- Remove publishing.md link from testing.md (file removed)
- Add sidebar order frontmatter to all doc pages for Starlight navigation
- Remove obsolete pages: getting-started.md (replaced by getting-started/walkthrough.md),
  publishing.md, registry.md, and section README.md files
- Remove Key features section from concept.md (duplicated navigation)
- Fix guide frontmatter: order → sidebar.order for Starlight compatibility

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@FL4TLiN3 FL4TLiN3 merged commit ea3cbb5 into main Feb 11, 2026
9 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.

1 participant