Aller au contenu principal

· 10 minutes de lecture
Endilie Yacop Sucipto

Docusaurus a été officiellement annoncé il y a plus de neuf mois comme moyen pour construire facilement des sites web de documentation open source. Depuis, il a accumulé plus de 8600 GitHub Stars, et est utilisé par de nombreux projets open source populaires tels que React Native, Babel, Jest, Reason et Prettier.

Il existe un dicton selon lequel le meilleur logiciel est en constante évolution, et le pire ne l'est pas. Si vous ne le savez pas, nous avons planifié et travaillé sur la prochaine version de Docusaurus 🎉.

· 8 minutes de lecture

« Joel et moi discutions de la possibilité d'avoir un site web et du fait que ça aurait été génial de se lancer avec. Je me suis donc mis au défi d'ajouter la prise en charge de Docusaurus. Il a fallu un peu plus d'une heure et demie. Je vais vous envoyer une PR avec l'ajout afin que vous puissiez jeter un coup d'oeil et voir si vous l'aimez. Votre flux de travail pour l'ajout de docs ne serait pas très différent de l'édition de ces fichiers Markdown. »

— Note envoyée à l'équipe Profilo

C'est l'histoire du voyage plutôt court qu'il a fallu pour créer le site web Profilo en utilisant Docusaurus.

Profilo, une bibliothèque Android pour collecter les traces de performance de la production, a été annoncée plus tôt cette année. Le projet a été publié sur GitHub avec moins d'une poignée de fichiers Markdown pour décrire sa fonctionnalité et aucun site web pour présenter toute identité visuelle et mettre en valeur le logo. La tâche à accomplir était de transformer ces documents et ce logo existants en un site web.

· 10 minutes de lecture
Joel Marcey

Nous sommes très heureux de vous présenter Docusaurus pour vous aider à gérer un ou plusieurs sites web open source.

Nous avons créé Docusaurus pour les raisons suivantes :

  1. Mettre l'accent sur la rédaction d'une bonne documentation au lieu de s'inquiéter de l'infrastructure d'un site Web.
  2. Fournir des fonctionnalités dont bon nombre de nos sites web open source ont besoin comme le support des blogs, la recherche et la mise en page.
  3. Faciliter l'envoi de mises à jour, de nouvelles fonctionnalités et de corrections de bogues pour tout le monde en même temps.
  4. Et enfin, donner une apparence et une sensation cohérentes à tous nos projets open source.