71 '<!-- CONFIRM -->' review markers across 19 files used HTML comment
syntax, which MDX cannot parse. One parse error breaks the whole
production build — this is why the deployed site 404'd on every page
while local dev limped along. All converted to {/* */} (code-fence
contents untouched). Also: remove the legacy source-'/' redirect,
replace the phantom architecture-diagram image with an ASCII diagram
until the real one lands.
Verified locally: mintlify broken-links parses all pages clean (one
known-good /api-reference tab link that 307s at runtime), and /,
/overview, /concepts/architecture, /quickstart, /patterns/*,
/versioning all render 200 with content.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
/ resolved into overview/use-cases because both overview.mdx and the
overview/ directory existed — move use-cases to /use-cases (redirected)
and remove the folder. Rewrite the landing as a mem0-style home: one
paragraph, the two-call loop, then card grids (start here / pick your
door / go deep / why) instead of the long-form pitch.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Serving the landing at / via an index page loops on Mintlify hosting
(/ -> first nav page /index -> normalized back to /). Use the /overview
slug instead: / redirects there once via Mintlify's built-in behavior,
/intro and legacy intro paths redirect to /overview, no destination is
bare / anymore.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
