docs: Add a docs page for migrating from Prettier to oxfmt.

[connorshea]

Made a few minor tweaks to the gist I wrote, still need to fill out the page to address a few TODOs

TODO:

• clarify/flesh out editor section
• Add code blocks/commands for other pkg managers

[netlify]

✅ Deploy Preview for oxc-project ready!

Name	Link
🔨 Latest commit	1b6613d
🔍 Latest deploy log	https://app.netlify.com/projects/oxc-project/deploys/6934cc35e610120008f2ef28
😎 Deploy Preview	https://deploy-preview-676--oxc-project.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[leaysgur]

Slightly updated:

• Use Oxfmt as product name vs Prettier, use oxfmt in command
• Wrap filename with `
• Apply diff syntax for shorter comparison
• Reduce height by arranging headings

[leaysgur]

Add code blocks/commands for other pkg managers

The 7-steps felt too long and likely to lower CVR for me 🙈, so just resolved this by removing them.

[leaysgur]

I think basic flow is fine! 😉

However, I'd like to simplify and shorten the text overall. Some sentences might even be okay to omit entirely.

Would you mind giving it a try?

The editor integration feels like it could easily fill a whole page on its own... 😅
Let's split it into separate page later and just include a link here for now.

[connorshea]

However, I'd like to simplify and shorten the text overall. Some sentences might even be okay to omit entirely.

Maybe we can replace the caveats section with a link to the FAQ? We should probably add a few of these caveats to the FAQ as well anyway. I think most of the rest of the page is necessary to avoid users running into problems with the migration process (plus I assume a lot of people will use Claude or Copilot to migrate their projects, so giving it as much info as we can is useful for that). I'll take a swing at updating the text tomorrow.

Let's split it into separate page later and just include a link here for now.

So cut the editor part down to just a link to the editor question in the FAQ? That sounds good to me 👍

[leaysgur]

Thank you in advance! 🙌🏻

just a link to the editor question in the FAQ?

Yes, if necessary, update that section and/or split out the editor-integration.md, etc.

[connorshea]

We could probably remove/shorten this part, since the 0.17.0 update on Monday will resolve a large part of this: The Oxfmt alpha only supports formatting JavaScript and TypeScript files (including those with JSX syntax). If you need support for non-JSX frameworks like Vue or Ember, or other languages like JSON, YAML, or Markdown, you will likely want to wait.

But otherwise I think I've shortened it as much as I can without removing relevant info. So, ready for re-review :)