Aller au contenu principal

Annonce de Docusaurus 2 Bêta

· 4 minutes de lecture
Sébastien Lorber
Sébastien Lorber
Mainteneur de Docusaurus, rédacteur de This Week In React
Joel Marcey
Joel Marcey
Représentant des développeurs chez Meta
Yangshun Tay
Yangshun Tay
Ingénieur Front End chez Meta
Alexey Pyltsyn
Alexey Pyltsyn
Passionné d'open source

After a lengthy alpha stage in order to ensure feature parity and quality, we are excited to officially release the first Docusaurus 2 beta.

With the announcement of this beta, the team is even more confident that Docusaurus 2 is ready for mainstream adoption!

Adoption de Docusaurus​

Don't fear the beta tag!

Docusaurus 2 est largement adopté et se développe rapidement :

Docusaurus v1 vs. v2 npm trends from 2019 to mid 2021. Les installations de Docusaurus v2 sont en forte augmentation, alors que la v1 est plutôt stable. La v1 fluctue entre 10 000 et 20 000, tandis que la v2 commence à 0 et termine à presque 60 000. The intersection happens around June 2020.

To get a fuller understanding of the quality of current Docusaurus 2 sites, our new showcase page allows you to filter Docusaurus sites by features, so you may get inspired by real-world production sites with a similar use-case as yours!

Don't miss our favorite sites; they all stand out with something unique:

A screenshot of the showcase's favorites section, with 12 cards each displaying the information and preview of one site

Pourquoi Docusaurus v2 a-t-il été en alpha pendant si longtemps ?​

It's hard to believe that the first alpha release v2.0.0-alpha.0 was 2 years ago 😳 , unusually long for a software alpha.

Comme il s'agissait d'une ré-architecture importante de la base de code, nous voulions nous assurer que nous avions confiance dans la stabilité et les fonctionnalités de Docusaurus 2 avant de passer à la phase bêta, puisque la phase bêta suggère un haut niveau de qualité. We are happy to say that Docusaurus 2 has reached feature parity with Docusaurus 1 with i18n, and it has been successfully adopted by many Docusaurus sites (see i18n showcase).

Nous sommes désormais convaincus que les fonctions principales de Docusaurus 2 sont suffisamment stables pour être en version bêta.

Quels sont les objectifs de la bêta ?​

Maintenant que Docusaurus 2 est stable et que ses principales fonctionnalités sont terminées, l'objectif de la version bêta est d'inspirer la confiance aux nouveaux utilisateurs quant à la capacité de production de Docusaurus 2, de faire migrer un plus grand nombre d'utilisateurs de Docusaurus 1 vers la version 2, et de déprécier officiellement Docusaurus 1. Nous continuerons bien sûr à résoudre les problèmes et les bogues qui pourraient être découverts.

In addition, we will use the beta phase to improve our theming system.

Nous voulons réussir :

  • easier to implement a custom theme, including for ourselves. We want to provide multiple official themes (including Tailwind CSS) for a long time.

  • safer to extend an existing theme: it can be painful to upgrade a highly customized Docusaurus site, as customizations can conflict with internal changes. Nous devons faire en sorte que la surface de l'API publique du thème soit plus explicite, et préciser ce qu'il est possible de personnaliser en toute sécurité.

We will build a better theming infrastructure and refactor the classic theme to use it.

Si vous personnalisez votre site, vous pourriez trouver ces améliorations prévues très utiles.

Quoi de neuf ?​

Au cas où vous l'auriez manqué, nous avons récemment apporté deux améliorations majeures :

Et ensuite ?​

Livraison de la version officielle 2.0 !

To get there, we will continue to fix bugs and implement the most wanted features, including:

Conclusion​

C'est un moment passionnant pour Docusaurus.

We are inspired by the positive feedback about Docusaurus, and discover new sites online every single day.

Nous sommes très heureux de cette version bêta. Nous avons recherché la qualité et la stabilité tout en continuant à essayer d'accroître l'adoption de Docusaurus. Pour ceux qui ont hésité à migrer un site Docusaurus existant vers Docusaurus 2, c'est le moment idéal pour le faire. Nous voulons que vous utilisiez l'infrastructure la plus récente lorsque nous abandonnerons Docusaurus 1 à la fin de cette période bêta. Faites-nous savoir comment nous pouvons aider.

Merci à tous ceux qui nous lisent et à toute la communauté qui soutient Docusaurus. 🤗