DP-46: Fix rendered docs navigation

[StiensWout]

Summary

• keep rendered Starlight docs links on rendered /docs/.../ routes while preserving raw .md routes for agents
• add explicit public docs navigation order for the user journey
• cover rendered docs links, raw Markdown routes, and navigation ordering in tests

Validation

• npm test
• npm --workspace website run build
• npm --workspace website run test
• npm run check:release-version
• npm run generate:schema
• git diff --exit-code -- schema/diagramspec-v1.schema.json
• npm run check:package-readiness
• npm run check:package-size-budgets
• npm run audit:fallow
• npm run audit:fallow:changed
• git diff --check

[linear-code]

DP-46

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
diagram-pilot-website	Ready	Preview, Comment	Jun 15, 2026 11:12am