Skip to content

Conversation

ethanpalm
Copy link
Contributor

Documentation changes

This PR updates https://mintlify.com/docs/guides/migration to include:

  • More information about the scraper (where files are stored, where to put them after you scrape)
  • High level guidance for doing a manual migration
  • Decision matrix for if you can use the scraper or not
  • Include GitBook as beta for automated migrations since it works, but not perfectly

Closes https://linear.app/mintlify/issue/DOC-22/migrations-guide-update


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

@ethanpalm ethanpalm merged commit 298bd17 into main Aug 1, 2025
4 checks passed
@ethanpalm ethanpalm deleted the migration-guides branch August 1, 2025 18:39
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