diff --git a/website/blog/releases/3.6/index.mdx b/website/blog/releases/3.6/index.mdx index 65e064d7cb..eb8e5ca1b3 100644 --- a/website/blog/releases/3.6/index.mdx +++ b/website/blog/releases/3.6/index.mdx @@ -24,20 +24,48 @@ This release has been mostly focused on build performance through the [Docusauru The [Docusaurus Faster](https://github.com/facebook/docusaurus/issues/10556) project's goal is to reduce the build times and memory consumption. -We are modernizing our infrastructure to use modern faster Rust-based tools, notably: +We have worked on multiple optimizations and modernized our infrastructure to use faster Rust-based tools, notably: - [Rspack](https://rspack.dev/): Fast Rust-based web bundler, almost drop-in replacement for [webpack](https://webpack.js.org/). - [SWC](https://swc.rs/): Speedy Web Compiler, Rust-based platform for the Web (HTML, CSS, JS). - [Lightning CSS](https://lightningcss.dev/): An extremely fast CSS parser, transformer, bundler, and minifier. -### Expected Impact +### Impact -Benchmarks on community site show that you can expect your site to build ⚡️**~3 times faster**! 🔥 +Adopting a new infrastructure can have various impacts. It's impossible to list them all exhaustively + +To help you adopt it easily, we have been fairly conservative in terms of expected static site output and [browser support](/docs/browser-support). + +#### Build Time + +Benchmarks on community site show that you can expect your production site to build ⚡️**2 to 4 times faster**! 🔥: - [React Native website](https://github.com/facebook/react-native-website/pull/4268): 3.04x faster 🔥 - [Babel website](https://github.com/babel/website/pull/2997): 3.27x faster 🔥 - [Lexical website](https://github.com/facebook/lexical/pull/6761): 2x faster 🔥 +[How to benchmark](https://github.com/facebook/docusaurus/issues/10556#issuecomment-2407671873) + +:::note About rebuilds + +[Rspack doesn't support persistent caching yet](https://rspack.dev/misc/planning/roadmap#persistent-cache), but it's on the roadmap and should be implemented soon. We think it's not a problem for the adoption of Rspack considering a cold Rspack build is usually as fast as warm Webpack build using persistent caching. + +::: + +#### Memory Consumption + +Apart from the new infrastructure, you should also see memory consumption improvements: + +- Rspack consumes way less memory during the bundling phase +- We fixed an important [memory leak](https://github.com/facebook/docusaurus/pull/10599) that affects in particular i18n sites +- We added [CI checks](https://github.com/facebook/docusaurus/pull/10601) to ensure that we don't regress, and that Docusaurus can build in a memory-constrained environment +- We worked on [internal tooling](https://github.com/facebook/docusaurus/pull/10590) to better understand which step of a Docusaurus build consumes memory +- We [removed a `process.exit(0)`](https://github.com/facebook/docusaurus/pull/10410) that may hide a memory leak you have in your own code + +#### Other Impacts + +- Our HTML minifier now [emits warnings in case of invalid HTML markup](https://github.com/facebook/docusaurus/discussions/10580) + ### Adoption Strategy This new infrastructure is a breaking change, but it is opt-in and does not require a new major version of Docusaurus.