Ir para o conteúdo principal

Recapitulação do Docusaurus 2019

· Leitura de 3 minutos
Yangshun Tay

2019 foi um ótimo ano para o Docusaurus - fizemos um ótimo progresso no Docusaurus 2. Os usuários atuais do Docusaurus 1 que não estão usando o recurso de traduções podem ficar à vontade para checar e migrar para ele! Caso contrário, trabalharemos com você para que isso aconteça em 2020 :)

Docusaurus 2 (D2)

Em 2018, sugerimos reconstruir o Docusaurus do zero. Isso envolveu um grande esforço de rearquitetura - criamos um framework CSS centrado no conteúdo a partir do zero, um sistema de plugins e movido de páginas HTML estáticas para ser um único aplicativo de página com rotas pré-renderizadas. Tratou-se de uma aventura selvagem e de um talento duro, especialmente sem um trabalho dedicado a este projecto. Com a ajuda de @endilie, nosso ex-estagiário que virou contribuidor que virou mantenedor, fizemos um progresso muito bom no D2 e atualmente estamos na versão 2.0.0-alpha.40. Todos os recursos do Docusaurus 1, exceto as traduções, foram transferidos.

Os recursos matadores do D2 são o Modo escuro e seu excelente desempenho. O D2 tem suporte para o modo escuro pronto para uso e é quase sem esforço criar um site de documentação amigável para o modo escuro. Endilie colocou grandes esforços para otimizar o desempenho do site e vários truques de otimização de desempenho foram feitos sob o capuz por padrão - imagens otimizadas, pré-renderizar todas as rotas para roteamento estático do lado do cliente e HTML depois, pré-buscar recursos necessários para futuras navegações sempre que o usuário passar sobre um link de navegação, etc.

Por último, mas não menos importante, implementamos uma arquitetura de plug-ins e transformamos o repositório em um Lerna monorepo. Acreditamos que essa arquitetura de plugins será útil para construir uma comunidade e também permite que os usuários criem suas próprias funcionalidades para seus casos únicos de uso.

Atividade do GitHub

  • Estrelas: 10050 -> 14632 (+45,6% y/y)
  • Total de Contribuidores: 182 -> 303 (+66.4% y/y). A maioria dos quais não são contribuidores do Facebook
  • Downloads Diários no npm: 728 -> 2320 (+218.7% y/y). O pico foi em novembro
  • O D1 é atualmente usado por 3872 projetos no GitHub, enquanto o D2 é usado por 247 projetos no GitHub
  • Agora temos 4 contribuintes centrais ativos! (+100% y/y)

Usuários Notáveis

Uma boa parte dos projetos dentro da comunidade Open Source usam o Docusaurus. Nesse meio nós incluímos mais projetos notáveis no Docusaurus 2:

E deu as boas-vindas a mais projetos ao Docusaurus 1:

Midia

Yangshun deu uma sessão de sala de aula durante o F8 sobre Usar o Docusaurus para criar sites de código aberto.

Comunidade

Alguns serviços de hospedagem/desenvolvimento de terceiros também têm integração de primeira classe com a configuração do Docusaurus:

Olhando para a Frente

D2 ganhou alguma força entre a comunidade de desenvolvedores. Em 2020, queremos atingir a paridade de recursos completos com D1 no primeiro semestre e ajudar os projetos restantes do Facebook em D1 a mudar para D2. Também seria ótimo se pudéssemos usar o Docusaurus para documentação interna, mas isso não é uma tarefa trivial. Se precisar ou tiver alguma ideia, venha falar conosco!

Muito obrigado à comunidade por suas contribuições, especialmente à equipe principal - Endilie Yacop Sucipto, Alexey Pyltsyn, Wei Gao. Por último, obrigado Joel Marcey por iniciar o Docusaurus e apoiar o projeto todo esse tempo.

Saudações a um ótimo 2020! 🎉