Skip to content

docs(home): add the product index as the Mintlify home page - #3300

Open
anubhavsinghmaar wants to merge 1 commit into
LambdaTest:stage-mintlifyfrom
anubhavsinghmaar:docs/mintlify-home-index
Open

docs(home): add the product index as the Mintlify home page#3300
anubhavsinghmaar wants to merge 1 commit into
LambdaTest:stage-mintlifyfrom
anubhavsinghmaar:docs/mintlify-home-index

Conversation

@anubhavsinghmaar

Copy link
Copy Markdown
Contributor

What

The Mintlify site has no way back to the rest of the documentation. It opens straight into the Kane CLI introduction, and every other product lives on the Docusaurus stack at /support/docs/ — so a reader who lands on Kane CLI docs is stuck there.

This makes /docs serve the same product index that /support/docs/ serves.

Link rules on the new home page:

  • Kane CLI → /docs/<slug> — stays inside Mintlify (8 links)
  • everything else → /support/docs/<slug>/ — goes to Docusaurus (105 links)

Changes

1. docs/index.mdx is now the product index (mode: "custom", 19 product cards)

Generated from src/pages/docs.js on testmuCom so the two grids stay in parity — same cards, same order, same labels, same NEW/BETA pills, same link targets. Verified identical: 19 cards / 113 links on both.

Styling follows the existing docs/index-backup.mdx (hero + search button + lg:grid-cols-4 card grid). Products that already had an icon there keep it; the new cards use cloud (Browser Cloud), terminal (Kane CLI) and robot (Agent Testing Platform).

2. The Kane CLI introduction moves to docs/kane-cli-introduction.mdx

Content is unchanged — only the frontmatter slug: / is dropped so the URL derives from the path, like every other page. The slug matches the one the Docusaurus stack already uses for the same page.

⚠️ Its URL changes from /docs to /docs/kane-cli-introduction. A Mintlify redirect cannot cover this, because /docs is now the home page. Anything currently pointing at /docs expecting the Kane CLI landing page (npm README, the kane-cli repo, CLI help output) will land on the product index instead — one extra click, not a 404.

3. docs.json navigation

docs/index becomes the first page of the Docs tab, above the Kane CLI group; docs/kane-cli-introduction replaces docs/index as the group's first entry. The sidebar on every Kane CLI page now shows a "TestMu AI Documentation" link back to the index.

Verification

Local mint dev:

URL Serves
/docs TestMu AI Documentation (new index)
/docs/kane-cli-introduction Kane CLI (moved, renders correctly)
/docs/kane-cli-installation Installing Kane CLI (unchanged)
  • docs.json is valid JSON; every docs/* nav entry resolves to a real file.
  • All 8 /docs/* links on the index resolve to existing .mdx files.
  • Screenshotted the index and a Kane CLI page — grid, pills and sidebar all render correctly.

Merge order

Merge this before the companion Docusaurus PRs (#3298stage, #3299testmuCom), which link to /docs/kane-cli-introduction.

🤖 Generated with Claude Code

The Mintlify site had no way back to the rest of the documentation - it opened
straight into the Kane CLI introduction, and every other product lives on the
Docusaurus stack at /support/docs/.

Make /docs the same product index that /support/docs/ serves, generated from
src/pages/docs.js on testmuCom so the two grids stay in parity (19 cards,
113 links). Kane CLI links stay inside Mintlify at /docs/<slug>; all 105 other
links point at /support/docs/<slug>/.

The Kane CLI introduction moves from docs/index.mdx to
docs/kane-cli-introduction.mdx, matching the slug the Docusaurus stack already
uses, and stays first in the Kane CLI sidebar group. Its URL changes from
/docs to /docs/kane-cli-introduction.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant