📚 Clearly communicate missing features when migrating from Prettier

[difosfor]

Documentation URL

https://biomejs.dev/

Description

The page and documentation currently claim nearly complete compatibility with Prettier, i.e. on the front page:

scores 97% compatibility with Prettier

Only when you click through on that can you read in the small print that embedded language support is outside of that scope. Also quite some languages are not supported when compared to Prettier.

Nowhere in the documentation can I find a clear list of missing features for people that are migrating:

• Migrate from ESLint and Prettier
• Differences with Prettier
• Language support

There are numerous related issues and discussions, but the migration experience is currently basically confusing if not misleading:

• Support formatting all files supported by prettier biome#3197
• ☂️ Biome - current developments biome#2455
• 📎 markdown support biome#3718
• 📎 Embedded language formatting biome#3334
• ..

Expectations

I suggest on the front page after the 97% compatibility with Prettier link you mention a brief list of unsupported feature names between parentheses. And you can link that to the Differences with Prettier page where you could detail those missing features and perhaps link to the related issues here on GitHub and/or how to contribute. And perhaps also document how to use Prettier alongside Biome as a fallback, i.e: to format file types not supported by Biome.

Code of Conduct

• I agree to follow Biome's Code of Conduct

[difosfor]

PS: Sorry if it's sounds like I'm just complaining or being too negative. I appreciate all of the work everybody's put into this and respect what you have accomplished so far. Feel free to close this ticket if it's out of place.

On a personal note: I really really wish for there to be an all-in-one commonly used conventional solution like Biome promises, saving everybody from having to spend lots of time to be able to have respectable tooling for what seems like pretty standard things. But after a long week of working on updating everything again and trying to get things working properly I currently feel just about ready to give up again.. I guess I want too much.