Microsoft-community/Community-website

Switching to VitePress

Closed this issue · 0 comments

VuePress 2 is a community maintained package and is a more modern version of VuePress. But problem lies here is it isn't officially supported, has an outdated design compared to other doc websites, and is slower.

VitePress is officially intended to be a replacement for VuePress and that's what we should switch to in the long term. It basically addresses all the cons of VuePress 2 I mentioned above, and is more accessibility friendly. It also provides more customizablility for the default theme.

I've did some work to preview what the site should look, function and feel like with a migration to VitePress. It should save us more hassle cause VitePress is closer to release than VuePress 2, thus reducing the chances we'll deal with major breaking changes in the future.

VuePress 2 also seems to be incompatible with other package managers (like pnpm), won't matter in production but it might make it harder to selfhost for those who do not use npm.

Original discussion.