Suite à la sortie de la v1, Meta s'est vite rendu compte de quelques limites de la v1:
- utilise React mais seulement coté serveur (pas d'hydratation ni de navigation Single-Page-Application
- le repo était assez monolithique, difficile à maintenir et tester
- pas très extensible, il n'y avait pas de système de plugin
- le theming était relativement limité, et les sites v1 se ressemblent beaucoup
En 2018, Meta a décidé de re-créer Docusaurus de 0, avec une toute nouvelle architecture:
- React utilisé coté client et serveur (comme Next.js, Remix, Gatsby…)
- Système de plugin: permet à la communauté de contribuer des features utiles (intégration OpenAPI, moteur de recherche local, support Sass…)
- Système de theming beaucoup plus flexible: possible d'overrider n'importe quel composant React du theme
- MDX (Markdown + React) pour rendre votre documentation interactive
Docusaurus 2.0 est en alpha/beta depuis 4 ans 🤪, et on vient enfin de sortir la 1ere version stable! On a retardé cette release car c'était pas évident de respecter le Semantic Versioning avant.
Aujourd'hui, Docusaurus sort avec un paquet de features, et il serait difficile de toutes les lister: docs, blog, versioning, theming, dark mode, i18n, a11y, SEO, TypeScript, PWA, Algolia DocSearch, MDX…