The "Why Vite?" button on the homepage is fairly "front and center" to me and is only a single click away: https://main.vitejs.dev/guide/why
"WTF IS IT?" is an endemic problem with marketing and startups.
Marketing is a skill, that many people in marketing so often don't have, and lot of leaders fail to grasp. It's so sad.
Imagine losing 1/2 of your potential uptake because of poor choice of words.
You have to deal with various layers of transpilation on your JS, styles and assets and that all needs to be flexible enough to fit a wide set of use cases for the community. It's gotten to the point you need to be an expert in all of the different ways you can bundle and deploy a JS app in order for the jargon associated with these tools to make any sense.
I see it over, over and over again.
I see young people pitching their tech and I have no f*ing clue what they are talking about.
I would say >50% of web sites don't do a very good job of explaining anything.
Vercel is one of the worst offenders.
That said - I feel for some of these dudes just wanting to make a framework, struggling a bit with the 'communication' part.
Literally one sentence.
- People might interpret that as "drop-in replacement for webpack", which is definitely not true
- Even as just "a replacement for webpack"; Webpack and Vite have a lot of overlap, and it makes sense to compare them, but I think there are too many asterisks and nuances to say they're equivalent, in official materials, unqualified
Just have a hyper link that directions to a comparison page explaining the nuance. Even without the hyperlink I wouldn’t assume people would think it’s a 1:1 clone drop in replacement. People don’t just drop in a new tool without research and comparing it against their new tool.