Skip to main content

Fix Docs Build Broken Relative Source Links

Summary​

Fixed the Quantago docs build failure caused by Docusaurus treating source-file markdown links inside an update note as broken site-relative pages.

Root Cause​

In docs/updates/05-01-2026/saas-stack/ctrader-2132-timeout-hardening.md, two references were written as markdown links:

  • services/backend/src/lib/ctrader/ctrader-order.ts
  • services/backend/src/lib/brokers/pepperstone-adapter.ts

Inside Docusaurus content pages, those were resolved as documentation routes under the current page path, which do not exist.

Fix​

Converted those source references from markdown links to plain inline code paths.

Validation​

Ran:

cd /Users/adam/github/saas-stack/projects/quantago/services/docs && pnpm build

Result:

  • Docusaurus build passed successfully.
  • Existing webpack warning about vscode-languageserver-types remains non-blocking.