Skip to content

docs: trim Get started and consolidate migration around mint migrate - #8653

Draft
cdxker wants to merge 2 commits into
mainfrom
denzell/docs-get-started-cleanup
Draft

cdxker wants to merge 2 commits into
mainfrom
denzell/docs-get-started-cleanup

Conversation

@cdxker

@cdxker cdxker commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

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 migrate page.

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.mdx rewritten: What is Mintlify (with the AI-native features), deploy, first change, plans and credits, next steps.
  • migration/index.mdx rewritten around mint migrate; ai-native and migration/{docusaurus,readme,gitbook,fern,document360,manual} deleted (English only).
  • 7 redirects added to redirects.json; inbound links in poc-onboarding, two help-center pages and mint-instructions/migrate updated.

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 to origin/main.
  • npx mint@4.3.81 validate: 4 errors, identical to origin/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.json only changes inside the Get started group.

Detail

  • Supported --from values, --topic names and --agent values come from packages/cli/migrate/ and packages/cli/src/migrate.ts on mint main. They match the existing cli/commands#mint-migrate reference.
  • Credits stay in the Reference group, since moving them would mean editing another nav group. The quickstart links to /credits and pricing.

Components

redirects.json

source destination
/ai-native /quickstart
/migration/{docusaurus,readme,gitbook,fern,document360,manual} /migration

docs.json

  • Removed ai-native; the Migration group became the single migration/index page.

help-center/

  • ZIP-export and Confluence pages now point to mint migrate --from <platform> instead of the deleted guides.

Warning

Callouts / Workarounds

  • mint validate fails on origin/main with 4 import-errors in snippets/dithering-example.jsx and snippets/recharts-example.jsx (npm imports); this PR doesn't touch them.
  • The scraper (@mintlify/scraping) instructions were removed with the platform guides, and the new page documents only mint 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 on quickstart.mdx. The quickstart also adds Plans and credits and streamlines deploy and first-edit steps.

Migration is one page at migration/index centered on mint migrate --from and coding agents, with platform and --topic references. Six English platform guides and migration/manual are deleted; Get started nav drops ai-native and lists only migration/index.

Redirects send /ai-native and /migration/{docusaurus,readme,gitbook,fern,document360,manual} to the new targets. Help-center ZIP/Confluence articles, poc-onboarding, and mint-instructions/migrate now point at mint migrate instead 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.

@mintlify

mintlify Bot commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 21, 2026, 12:37 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

1 active deployment
staging — b6a6126f Deployed Nov 21, 2026 by mintlify[bot]
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