React Hebdo #114: 🎉 lancement officiel de Docusaurus 2.0 🥳️

Bonjour à tous!

🎉 Aujourd'hui, c'est le lancement officiel de Docusaurus 2.0! Le projet Meta Open Source (Facebook) dont je suis le mainteneur principal.

🙏 On lance aussi ProductHunt, Hacker News et Twitter: si vous aimez le projet, n'hésitez pas a voter et donner votre avis sur Docusaurus 😃 Faites le maintenant svp, demain ça sera trop tard 🙏 Ca aide beaucoup d'avoir une bonne traction initiale, et j'espère que vous me soutiendrez!

🎙️ Ca tombe bien, mon podcast sur Docusaurus avec The Developer’s Bakery vient également de sortir 😉

Prochaine édition de news React prévue en fin de semaine.

Meta a plein de projets internes/externes, qu'il faut à chaque fois documenter. C'est déjà compliqué d'écrire de la doc, alors si en plus il faut faire un site sur mesure à chaque fois, ça prend beaucoup de temps.

En 2017 ils ont commencé à copier/coller un template Jekyll pour chaque projet, mais c'est vite devenu difficile à maintenir.

En 2017, ils ont décidé de créer Docusaurus, un générateur de sites statiques en Node.js basé sur React, qui va “cacher” la stack technique du site et permettre de se concentrer sur le contenu: l'écriture des fichiers Markdown. On peut comparer cet outil à Create-React-App, mais pour créer des sites de contenu: docs, blog, landing pages…

La v1 de Docusaurus est vite devenue assez populaire, utilisée par React-Native, Jest, Babel, Prettier…

Suite à la sortie de la v1, Meta s'est vite rendu compte de quelques limites de la v1:

En 2018, Meta a décidé de re-créer Docusaurus de 0, avec une toute nouvelle architecture:

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…

Un paquet d'entreprises ont déjà adopté Docusaurus 2.0 malgré le fait qu'il soit en beta. La v2 est déjà bien plus populaire que la v1, et on la presque la moitié des downloads npm de Gatsby!

Notre site showcase contient déjà près de 300 sites.

Et il est loin d'être exhaustif puisque de nombreux sites n'ont pas encore été ajoutés: Figma, Snapchat, Courier, 1Password…

Sans compter les nombreux sites internes d'entreprises comme Microsoft, LinkedIn, Shopify…

Quelques exemples:

On a aussi pas mal de sites avec de belles customizations qui respectent vraiment l'image de marque de l'entreprise.

Il y a 2 ans, j'étais tranquillement en train de faire ma veille sur Twitter quand je tombe sur ça:

Je me suis dit que c'était une super occasion: travailler pour Facebook en freelance sur un projet open-source, ça n'arrive pas tous les jours. Initialement, cela devait durer 3 mois, mais durera finalement beaucoup plus longtemps: je travaille sur Docusaurus depuis plus de 2 ans maintenant!

J'ai la chance de pouvoir travailler de manière très flexible, avec une grande autonomie, ce qui me permet aussi de faire tourner cette newsletter à coté.

C'est super cool de voir Docusaurus devenir populaire, j'ai vraiment l'impression que mon travail à un réel impact. J'espère vous avoir donné envie de tester cet outil et j'ai hâte de voir les sites que vous allez créer! N'oubliez pas de les envoyer sur notre site showcase!

Pour faire du lancement un succès, n'hésitez pas à nous donner un coup de main en visibilité. Un upvote, retweet, ou un commentaire nous aide beaucoup!

Les principales plateformes du lancement: