Migration FAQ
Frequently Asked Questions
General Questions
❓ Q: How long does the migration process take?
A: The migration process takes approximately 30 minutes. During this time, your project dashboard will be temporarily disabled, but your docs will remain live and accessible to your users.
❓ Q: Will my existing documentation be affected?
A: No, your existing documentation will remain accessible throughout the migration process. Once migrated, all your content will be preserved in the new experience.
❓ Q: Can I revert back to the old experience after migrating?
A: No, the migration to the new ReadMe Refactored experience is a one-way process. Once migrated, you'll have access to new features like MDX components and in-docs editing.
❓ Q: Will my team need to learn new tools or processes?
A: The new experience is designed to be intuitive and user-friendly. While it introduces new features like MDX components, the core editing experience will feel familiar.
Feature-Specific Questions
❓ Q: What happens to my existing Markdown content?
A: While most of your Markdown content will render the same way in the new MDX-powered editor, there may be some minor updates to your existing content required. We'll automatically convert your content during migration, but we recommend reviewing your docs afterward to ensure everything appears as expected.
❓ Q: How does bi-directional Git syncing work?
A: Bi-directional Git syncing allows you to sync your documentation between ReadMe and GitHub. After migration, you can set up syncing to maintain your docs in either platform.
❓ Q: Will my API documentation still work?
A: Yes, your API documentation will continue to work. If you're using API v1, you'll need to enable bi-directional syncing to continue updating your docs.
Feature Compatibility Guide
Fully Supported Features
- ✅ Direct in-docs editing
- ✅ MDX components
- ✅ Bi-directional GitHub sync
- ✅ Custom domains
- ✅ API Reference (OpenAPI/Swagger)
- ✅ Guides and documentation
- ✅ Custom pages
- ✅ Changelog
Features Requiring Updates
- ⚠️ API v1 Integration
- Requires enabling bi-directional sync
- Alternative: Use GitHub sync for documentation updates
- ⚠️ RDME CLI / GitHub Actions
- Requires enabling bi-directional sync
- Alternative: Use GitHub sync for documentation updates
Currently Unavailable Features
- ❌ AWS Gateway integration
- ❌ Manual Editor
- ❌ Owlbot integration
Alternative Solutions
If you're currently using features that aren't supported in the new experience, our support team can help you transition to supported alternatives. Please reach out to our support team for assistance in planning your migration strategy.
Getting Help
Need additional support or have questions not covered here? We're here to help:
- Contact support
- Enterprise customers: Reach out to your Customer Success Manager
- Check our documentation for the latest updates and guides
Updated about 19 hours ago