Repository navigation
Conversation
…orm migration guides with mint migrate
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
cdxker
marked this pull request as draft
November 21, 2026 00:35
This branch was successfully deployed
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.
Cut the quickstart to one short page with a "What is Mintlify" section, folded AI-native into it, and replaced the six platform migration guides with one
mint migratepage.clank context (clickme)
Description
Implements the Get started whiteboard notes: shorter quickstart, no standalone AI-native page, one migration page built on
mint migrate, and credits surfaced from Get started.quickstart.mdxrewritten: What is Mintlify (with the AI-native features), deploy, first change, plans and credits, next steps.migration/index.mdxrewritten aroundmint migrate;ai-nativeandmigration/{docusaurus,readme,gitbook,fern,document360,manual}deleted (English only).redirects.json; inbound links inpoc-onboarding, two help-center pages andmint-instructions/migrateupdated.Test Plan
npx mint@4.3.81 broken-links: no broken links found.npx mint@4.3.81 broken-links --check-anchors: 36 broken links, identical output toorigin/main.npx mint@4.3.81 validate: 4 errors, identical toorigin/main(see callout).English only, to keep review small; es, fr and zh pages and nav are untouched and will follow separately. A separate PR is reordering the top-level nav groups, so
docs.jsononly changes inside the Get started group.Detail
--fromvalues,--topicnames and--agentvalues come frompackages/cli/migrate/andpackages/cli/src/migrate.tson mintmain. They match the existingcli/commands#mint-migratereference./creditsand pricing.Components
redirects.json/ai-native/quickstart/migration/{docusaurus,readme,gitbook,fern,document360,manual}/migrationdocs.jsonai-native; the Migration group became the singlemigration/indexpage.help-center/mint migrate --from <platform>instead of the deleted guides.Warning
Callouts / Workarounds
mint validatefails onorigin/mainwith 4import-errors insnippets/dithering-example.jsxandsnippets/recharts-example.jsx(npm imports); this PR doesn't touch them.@mintlify/scraping) instructions were removed with the platform guides, and the new page documents onlymint migrate.Note
Medium Risk
Large doc deletions and redirect reliance for bookmarked URLs; localized sites still expose old migration structure until a follow-up PR.
Overview
Get started is shorter: the standalone AI-native page is removed and its overview (assistant, agent,
llms.txt/ MCP) lives under What is Mintlify onquickstart.mdx. The quickstart also adds Plans and credits and streamlines deploy and first-edit steps.Migration is one page at
migration/indexcentered onmint migrate --fromand coding agents, with platform and--topicreferences. Six English platform guides andmigration/manualare deleted; Get started nav dropsai-nativeand lists onlymigration/index.Redirects send
/ai-nativeand/migration/{docusaurus,readme,gitbook,fern,document360,manual}to the new targets. Help-center ZIP/Confluence articles,poc-onboarding, andmint-instructions/migratenow point atmint migrateinstead of removed guides. Scraper-heavy manual workflows are no longer documented in English (Spanish/French nav and pages are unchanged in this PR).Reviewed by Cursor Bugbot for commit b6a6126. Bugbot is set up for automated code reviews on this repo. Configure here.