Mintlify v2 Directory Structure and Versioned Navigation #1208
Conversation
![mintlify[bot]](https://avatars.githubusercontent.com/in/222410?s=80&v=4){kind=small}
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
This PR is being reviewed by Cursor Bugbot
Details
Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.
To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.
| </Card> | ||
| <Card title="Set up API references" icon="code" href="/v2/api-playground/overview" horizontal> | ||
| Create interactive API references with OpenAPI and AsyncAPI specifications. | ||
| </Card> |
There was a problem hiding this comment.
Bug: Broken Links in V2 Documentation
Several links in v2/index.mdx, v2/quickstart.mdx, and v2/installation.mdx point to v2/editor, v2/text, v2/components, and v2/api-playground paths. These pages aren't currently part of the v2 documentation or its navigation structure, which will lead to 404 errors for users.
Additional Locations (4)
| <Card title="Add interactive components" icon="puzzle" href="/v2/components/accordions" horizontal> | ||
| Enhance your documentation with interactive components like accordions, tabs, and code samples. | ||
| </Card> | ||
| <Card title="Set up API references" icon="code" href="/v2/api-playground/overview" horizontal> |
There was a problem hiding this comment.
Bug: Broken Links in v2 Documentation
It looks like a few links in v2/installation.mdx and v2/quickstart.mdx point to pages that aren't part of the v2 navigation, like /v2/api-playground/migrating-from-mdx, /v2/api-playground/overview, and /v2/components/accordions. Users clicking these will hit 404s.
Additional Locations (1)
| "v2/settings", | ||
| "v2/pages", | ||
| "v2/navigation", | ||
| "v2/themes" |
There was a problem hiding this comment.
Bug: Missing Documentation Pages Cause Navigation Errors
The new v2.0 navigation in docs.json and hero cards in v2/index.mdx reference several v2 documentation pages (e.g., v2/settings, v2/editor, v2/text) that are not included in this commit. Users will encounter 404 errors when trying to access these missing pages.
Additional Locations (2)
1 participant
Created a new v2 directory structure and implemented versioned navigation to support both v1 and v2 documentation. The existing documentation now serves as v1 while new v2 content has been established with updated navigation structure.
Files changed: