Cortex public documentation
This is the Mintlify site fordocs.cortex.foundation. Edit the site at the
repository root, not in apps/docs. Preview and validation commands are in
README.md.
- Keep product copy in English and use the Cortex product names and domains.
- Do not publish authentication/session internals, credentials, private API routes, farm details, or backend operator runbooks.
- Preserve the Home + Documentation navbar and ink-on-cream CTAs.
- Keep every navigation slug backed by a page and every problem page’s
typeURL onhttps://docs.cortex.foundation/problems/{code}. - One hub page per product (
<product>/index.mdx). Do not add a second overview page beside it, and give every page atitle, adescription, and a closing Related or Next section. - Keep
descriptionunder 160 characters so it is not truncated in search results and link previews. Where the product’s sidebar label differs from the page title (the sidebar says Artifacts, the page is Library), add the label tokeywordsso either term finds the page. - Run
node scripts/check-docs-site.mjsandbash scripts/tests/check-docs-site.test.sh, thennode scripts/tests/docs-ui.test.mjsandnpm exec --yes --package=mint@4.2.876 -- mint validatebefore committing. - For error-code or endpoint changes, also run the checker with a backend checkout as its first argument. Coordinate the two PRs; the backend owns the API contract and checks this repository in its CI.
- Do not change the Mintlify integration, custom domain, or DNS without an explicit request.

