Ir para o conteúdo principal

Anunciando Docusaurus 2 Beta

· Leitura de 4 minutos
Sébastien Lorber
Docusaurus maintainer, This Week In React editor
Joel Marcey
Developer Advocate at Meta
Yangshun Tay
Front End Engineer at Meta
Alexey Pyltsyn
Open-source enthusiast

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!

Adopção do Docusaurus

Don't fear the beta tag!

O Docusaurus 2 é amplamente adotado e está crescendo rapidamente:

Docusaurus v1 vs. v2 npm trends from 2019 to mid 2021. As instalações do Docusaurus v2 estão subindo drasticamente, enquanto a v1 é principalmente estável. V1 flutua entre 10000 e 20000, enquanto o v2 começa em 0 e termina em quase 60000. 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

Por que o Docusaurus v2 estava em alfa por tanto tempo?

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.

Como esta foi uma re-arquitetura substancial da base de código, queríamos ter certeza de que tínhamos confiança na estabilidade e nos recursos do Docusaurus 2 antes de passar para o estágio beta, já que o beta sugere um alto nível de qualidade. 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).

Agora estamos confiantes de que os principais recursos do Docusaurus 2 são estáveis o suficiente para estar no beta.

Quais são os objetivos da beta?

Agora que o Docusaurus 2 está estável e os principais recursos completos, o objetivo do beta é inspirar confiança nos novos usuários sobre a prontidão de produção do Docusaurus 2, migrar mais usuários do Docusaurus 1 para a versão 2 e oficialmente descontinuar o Docusaurus 1. Obviamente, continuaremos a resolver quaisquer problemas e bugs que possam ser descobertos.

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

Queremos fazer:

  • 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. Precisamos tornar a superfície da API pública do tema mais explícita e deixar claro o que é seguro personalizar.

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

Se você personalizar seu site, poderá achar essas melhorias planejadas muito valiosas.

Quais as novidades?

Caso você tenha perdido, recentemente enviamos duas melhorias importantes:

O que vem a seguir?

Enviando a versão 2.0 oficial!

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

Conclusão

Este é um momento emocionante para o Docusaurus.

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

Estamos muito animados com este lançamento beta. Buscamos qualidade e estabilidade enquanto continuamos a tentar aumentar a adoção do Docusaurus. Para aqueles que estão em dúvida quanto à migração de um site existente do Docusaurus para o Docusaurus 2, é um ótimo momento para atualizar. Queremos que você execute a infraestrutura mais recente quando descontinuarmos o Docusaurus 1 no final deste período beta. Nos diga como podemos ajudar.

Obrigado a todos pela leitura e a toda a comunidade que apoia o Docusaurus. 🤗