Após um longo estágio alfa para garantir paridade e qualidade de recursos, estamos ansiosos para lançar oficialmente o primeiro Docusaurus 2 beta.
Com o anúncio dessa versão beta, o time está ainda mais confiante de que o Docusaurus 2 está pronto para adoção convencional!
Adopção do Docusaurus
Não tenha medo da tag beta!
O Docusaurus 2 é amplamente adotado e está crescendo rapidamente:
Para obter uma compreensão mais completa da qualidade dos sites atuais do Docusaurus 2, nossa nova página de showcase permite que você filtre os sites do Docusaurus por recursos, para que você possa inspire-se em sites de produção do mundo real com um caso de uso semelhante ao seu!
Não perca nossos sites favoritos; todos eles se destacam com algo único:
Por que o Docusaurus v2 estava em alfa por tanto tempo?
É difícil acreditar que a primeira versão alfa v2.0.0-alpha.0 foi há 2 anos 😳, excepcionalmente longo para um software alfa.
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. Estamos felizes em dizer que Docusaurus 2 atingiu paridade de recurso com Docusaurus 1 com i18n, e foi adotado com sucesso por muitos Sites Docusaurus (consulte showcase i18n).
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.
Além disso, usaremos a fase beta para melhorar nosso sistema de temas.
Queremos fazer:
-
mais fácil de implementar um tema personalizado, inclusive para nós mesmos. Queremos fornecer vários temas oficiais (incluindo Tailwind CSS) por um longo tempo.
-
mais seguro estender um tema existente: pode ser doloroso atualizar um site Docusaurus altamente personalizado, pois as personalizações podem entrar em conflito com as mudanças internas. Precisamos tornar a superfície da API pública do tema mais explícita e deixar claro o que é seguro personalizar.
Vamos construir uma infraestrutura de temas melhor e refatorar o tema clássico para usá-lo.
Se você personalizar seu site, poderá achar essas melhorias planejadas muito valiosas.
Quais as novidades?
Caso você tenha perdido, recentemente enviamos duas melhorias importantes:
- Barras laterais geradas automaticamente: não é necessário manter um arquivo de
sidebars.js! - Webpack 5 / PostCSS 8: o cache persistente acelera significativamente a hora de reconstruir!
O que vem a seguir?
Enviando a versão 2.0 oficial!
Para chegar lá, continuaremos a corrigir bugs e implementar os ** recursos mais desejados**, incluindo:
- Páginas de índice de categorias da barra lateral
- Melhor UX de navegação móvel
- Melhor design de avisos
- Suporte CSS-in-JS
- Melhorar o desempenho do build
- Estender plugins Docusaurus, integração CMS
- Corrigir barras finais e problemas de link relativo
- Melhor compatibilidade com CommonMark
- Atualizar para MDX 2.0
Conclusão
Este é um momento emocionante para o Docusaurus.
Somos inspirados pelo feedback positivo sobre o Docusaurus e descobrimos novos sites online todos os dias.
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. 🤗