Ir para o conteúdo principal

Recapitulação do Docusaurus 2020

· Leitura de 6 minutos
Sébastien Lorber
Docusaurus maintainer, This Week In React editor

2020 was great for Docusaurus, despite a regrettable start and a tumultuous year for everyone.

We continued to invest in Docusaurus 2, and made it reach full feature parity with Docusaurus 1.

We now recommend Docusaurus 2 as the default choice to start a new Docusaurus project and encourage v1 users to migrate to Docusaurus 2.

We are still in alpha, but expect some good news very soon!

Three Docusaurus plushies laid side-by-side on the table

Destaques do Docusaurus 2

Trabalhámos sobre muitos aspectos este ano e gostaríamos de destacar os mais significativos:

  • i18n: easily translate your Docusaurus site, released soon! (preview, doc)
  • Version dropdown: enable contextual version switch
  • Versioning options: solving the most common pain-points users had with versioning
  • Contextual search: search in the current version, use the brand-new DocSearch 3 experience
  • Markdown pages: use Markdown instead of React components to create standalone pages
  • Better theme: various UI, UX and accessibility improvements
  • PWA: add offline support to your site, and make it installable
  • Fail-fast: strict config validation, detect broken links, and prevent bad production deployments
  • Multi-instance: use the docs plugin twice on a single site (e.g. iOS/Android SDK docs)
  • Migration CLI: automate the upgrade from Docusaurus 1
  • CodeSandbox: assess Docusaurus easily from your browser with new.docusaurus.io
  • Canary releases: use the @canary npm tag to use the upcoming release before anyone else
  • TypeScript: progressive adoption for internal code, and improve usage for users
  • Publish Infima: it is now open-source

Crescimento do Docusaurus 2

The plan to rebuild Docusaurus from scratch in 2019 paid off: after a slow start, Docusaurus 2 has been widely adopted and has already outgrown Docusaurus 1 usage.

Docusaurus v1 vs. v2 npm trends of the year 2020. The installations of Docusaurus v2 is visibly up-growing, while v1 is slightly downward. V1 starts at 15000 and ends at 10000, while v2 starts at 2000 and ends at 25000. The intersection happens around June 2020.

Notable projects, startups, large companies, and individuals adopted Docusaurus 2 (showcase):

We helped large scale Docusaurus 1 sites to upgrade, ensuring a proper migration path and feature parity.

React Native was successfully upgraded to Docusaurus 2 (archived v1 site):

React Native's new website built with Docusaurus v2

Localized Docusaurus 1 sites (like Jest) will be able to upgrade too:

Jest's new website built with Docusaurus v2 in Japanese

We also saw the first right-to-left Docusaurus 2 site published:

Datagit's website in Persian, a right-to-left language. The sidebar appears on the right of the window and the TOC appears on the left.

Atividade do GitHub

  • Stars: 14632 → 20946 (+43.2% y/y)
  • Total Contributors: 303 → 512 (+68.9% y/y). A maioria dos quais não são contribuidores do Facebook
  • Weekly npm Downloads: 2356 → 25592 (+986% y/y)
  • On GitHub, Docusaurus 1 is used by 6311 projects (+62.9% y/y) while Docusaurus 2 is used by 5039 projects (+1940% y/y)

Colaboração com Major League Hacking

We have welcomed Major League Hacking (MLH) fellows for 2 seasons already.

We are very thankful for the various contributions they made, such as:

  • Escrevendo as fundações da v1 para a migração de v2 CLI
  • Ajudando a migrar o site React Native de v1 para v2
  • Tornando a validação de configuração mais estrita e exaustiva, retornando mensagens de erro úteis
  • Adicionando suporte ao CodeSandbox
  • Melhorando os pipelines de CI: tamanho da compilação e bots do Lighthouse

Esperamos continuar esta colaboração em 2021.

Midia

Dmitry Vinnik (Developer Advocate @ Facebook) explains Docusaurus in 60 seconds or 15min videos.

Rachel Nabors (Documentation Engineer @ Facebook) talked a bit about Docusaurus in React Native Radio 178 (podcast), and William Candillon the React Native website migration (video).

Muitas postagens foram publicadas:

Comunidade

The Docusaurus community continues to grow, the Discord server is quite active, and Stack Overflow questions keep being posted.

The modular architecture of Docusaurus 2 allowed the community to build and publish third-party plugins. As we would like to federate better our community, if you are building a plugin, please let us know.

O que vem a seguir?

As the core features of Docusaurus 2 have finally been built, we will be able to dedicate more time to solve the pain points and bugs reported by the community, and make Docusaurus stable and convenient enough to enter the beta and release-candidate phase.

With proper support for i18n and versioning, and large scale migrations such as React Native and Jest, we now have a clear migration path for all Docusaurus 1 sites.

We still have a few major features that we would like to work on:

Huge thanks to the community for their contributions in 2020, especially:

  • Joel Marcey for creating Docusaurus and supporting the project all this time
  • the core team - Alexey Pyltsyn, Sébastien Lorber, Yangshun Tay
  • os estagiários da Major League Hacking do Facebook por seu impacto significativo
  • a equipe do Algolia pelo DocSearch 3 e seu apoio
  • Bartosz Kaszubowski for his investment in the React Native migration
  • toda a comunidade pelas suas contribuições e oferecendo apoio uns aos outros

Saudações a um ótimo 2021! 🎉