// the find
facebook/docusaurus
Easy to maintain open source documentation websites.
Docusaurus is a React-based static site generator purpose-built for documentation. It handles versioning, i18n, MDX, and search out of the box. If you need a documentation site for an open-source project and don't want to build the plumbing yourself, this is the obvious choice.
The versioned docs system is genuinely well thought out — you can snapshot docs per release without manual file management. MDX support is first-class, so you can embed live code demos and custom React components directly in markdown. The swizzling mechanism lets you override any internal component without forking the whole theme. Build performance has improved significantly with the Rspack bundler option in recent versions.
The plugin and theme API surface is enormous and underdocumented in places — swizzling a component often means wading through internals that aren't stable across minor versions. Cold build times on large doc sites are still painful even with the faster bundler option. The default classic theme is starting to show its age visually and customizing it deeply enough to not look like every other Docusaurus site requires significant CSS work. No built-in full-text search without a third-party integration (Algolia DocSearch requires an application, local search plugins are community-maintained and inconsistent).