Problem
Some markdown content files in the docs directory contain relative links like [CLI Guide](CLI_GUIDE.md) which resolve to 404 pages. They should link to the website doc routes like /docs/cli-guide/.
Broken links found in /docs/getting-started/:
CLI_GUIDE.md → should be /docs/cli-guide/
USAGE_GUIDE.md → should be /docs/usage-guide/
LSP_GUIDE.md → should be /docs/lsp-guide/
TROUBLESHOOTING.md → no equivalent page yet
MCP_GUIDE.md → should be /docs/mcp-guide/
LINTING_RULES.md → should be /docs/linting-rules/
CONFIGURATION.md → should be /docs/configuration/
API_REFERENCE.md → should be /docs/api-reference/
SQL_COMPATIBILITY.md → should be /docs/sql-compatibility/
../examples/ → no equivalent page yet
Fix
Audit all markdown files in docs/ for relative .md links and replace with absolute website paths.
Problem
Some markdown content files in the docs directory contain relative links like
[CLI Guide](CLI_GUIDE.md)which resolve to 404 pages. They should link to the website doc routes like/docs/cli-guide/.Broken links found in
/docs/getting-started/:CLI_GUIDE.md→ should be/docs/cli-guide/USAGE_GUIDE.md→ should be/docs/usage-guide/LSP_GUIDE.md→ should be/docs/lsp-guide/TROUBLESHOOTING.md→ no equivalent page yetMCP_GUIDE.md→ should be/docs/mcp-guide/LINTING_RULES.md→ should be/docs/linting-rules/CONFIGURATION.md→ should be/docs/configuration/API_REFERENCE.md→ should be/docs/api-reference/SQL_COMPATIBILITY.md→ should be/docs/sql-compatibility/../examples/→ no equivalent page yetFix
Audit all markdown files in
docs/for relative.mdlinks and replace with absolute website paths.