Skip to content

fix(website): broken .md relative links in docs content files #398

@ajitpratap0

Description

@ajitpratap0

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingwebsite

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions