Skip to content

Add migration guides - #6996

Open
ethanpalm wants to merge 13 commits into
mainfrom
docs/doc-409-migration-guides
Open

Add migration guides#6996
ethanpalm wants to merge 13 commits into
mainfrom
docs/doc-409-migration-guides

Conversation

@ethanpalm

@ethanpalm ethanpalm commented Aug 17, 2026

Copy link
Copy Markdown
Collaborator

Documentation changes

Creates a migration group with individual guides for frequently migrated from platforms.

Closes https://linear.app/mintlify/issue/DOC-409/migration-guides-for-each-major-competitor-platform


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Note

Low Risk
Documentation and navigation-only changes with URL redirects; no application code, auth, or data handling.

Overview
Replaces the single Migrate to Mintlify page with a migration section: a hub at migration/index plus dedicated guides for Docusaurus, ReadMe, GitBook, Fern, Document360, manual/other platforms, and a go-live checklist.

Navigation in docs.json now lists this as the Migrate to Mintlify group under Get started (root: migration/index with seven child pages). The old migration.mdx is removed.

Redirects send /migration and /guides/migration to /migration/index. Banner examples in EN/ES/FR/ZH point migration links to /migration/index instead of /migration.

Reviewed by Cursor Bugbot for commit abde9c9. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 17, 2026, 5:46 PM

@mintlify

mintlify Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
tomee 🟡 Building Aug 17, 2026, 5:45 PM

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

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