docs(home): add the product index as the Mintlify home page - #3300
Open
anubhavsinghmaar wants to merge 1 commit into
Open
docs(home): add the product index as the Mintlify home page#3300anubhavsinghmaar wants to merge 1 commit into
anubhavsinghmaar wants to merge 1 commit into
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
/docsserve the same product index that/support/docs/serves.Link rules on the new home page:
/docs/<slug>— stays inside Mintlify (8 links)/support/docs/<slug>/— goes to Docusaurus (105 links)Changes
1.
docs/index.mdxis now the product index (mode: "custom", 19 product cards)Generated from
src/pages/docs.jsontestmuComso 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-4card grid). Products that already had an icon there keep it; the new cards usecloud(Browser Cloud),terminal(Kane CLI) androbot(Agent Testing Platform).2. The Kane CLI introduction moves to
docs/kane-cli-introduction.mdxContent 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./docsto/docs/kane-cli-introduction. A Mintlify redirect cannot cover this, because/docsis now the home page. Anything currently pointing at/docsexpecting the Kane CLI landing page (npm README, thekane-clirepo, CLI help output) will land on the product index instead — one extra click, not a 404.3.
docs.jsonnavigationdocs/indexbecomes the first page of the Docs tab, above the Kane CLI group;docs/kane-cli-introductionreplacesdocs/indexas 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:/docs/docs/kane-cli-introduction/docs/kane-cli-installationdocs.jsonis valid JSON; everydocs/*nav entry resolves to a real file./docs/*links on the index resolve to existing.mdxfiles.Merge order
Merge this before the companion Docusaurus PRs (#3298 →
stage, #3299 →testmuCom), which link to/docs/kane-cli-introduction.🤖 Generated with Claude Code