From 68a116611f45a561f329cb9b0d0d179b30e2fb57 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= <slorber@users.noreply.github.com>
Date: Thu, 21 Oct 2021 18:52:17 +0200
Subject: [PATCH] chore: prepare v2.0.0-beta.8 release (#5762)

---
 CHANGELOG.md                                  |  80 ++++++++++
 admin/new.docusaurus.io/package.json          |   2 +-
 lerna.json                                    |   2 +-
 packages/create-docusaurus/package.json       |   2 +-
 .../templates/classic-typescript/package.json |   8 +-
 .../templates/classic/package.json            |   6 +-
 .../templates/facebook/package.json           |   6 +-
 .../docusaurus-cssnano-preset/package.json    |   2 +-
 packages/docusaurus-mdx-loader/package.json   |   8 +-
 packages/docusaurus-migrate/package.json      |   2 +-
 .../package.json                              |   2 +-
 .../package.json                              |  12 +-
 .../package.json                              |  12 +-
 .../package.json                              |  14 +-
 .../package.json                              |  12 +-
 packages/docusaurus-plugin-debug/package.json |   8 +-
 .../package.json                              |   6 +-
 .../package.json                              |   6 +-
 .../package.json                              |   8 +-
 packages/docusaurus-plugin-pwa/package.json   |  10 +-
 .../docusaurus-plugin-sitemap/package.json    |  12 +-
 .../docusaurus-preset-classic/package.json    |  22 +--
 .../package.json                              |   2 +-
 .../docusaurus-theme-classic/package.json     |  22 +--
 packages/docusaurus-theme-common/package.json |  14 +-
 .../package.json                              |   6 +-
 .../package.json                              |  10 +-
 packages/docusaurus-types/package.json        |   2 +-
 packages/docusaurus-utils-common/package.json |   4 +-
 .../docusaurus-utils-validation/package.json  |   4 +-
 packages/docusaurus-utils/package.json        |   4 +-
 packages/docusaurus/package.json              |  14 +-
 packages/lqip-loader/package.json             |   2 +-
 packages/stylelint-copyright/package.json     |   2 +-
 website/package.json                          |  16 +-
 .../api/themes/theme-bootstrap.md             |  25 ---
 .../_partials/swizzleWarning.mdx              |   0
 .../api/docusaurus.config.js.md               |   2 +-
 .../api/plugins/overview.md                   |   0
 .../api/plugins/plugin-client-redirects.md    |   0
 .../api/plugins/plugin-content-blog.md        |  21 +++
 .../api/plugins/plugin-content-docs.md        |   6 +
 .../api/plugins/plugin-content-pages.md       |   0
 .../api/plugins/plugin-debug.md               |   0
 .../api/plugins/plugin-google-analytics.md    |   0
 .../api/plugins/plugin-google-gtag.md         |   0
 .../api/plugins/plugin-ideal-image.md         |   0
 .../api/plugins/plugin-pwa.md                 |   0
 .../api/plugins/plugin-sitemap.md             |   0
 .../api/themes/overview.md                    |   2 +-
 .../api/themes/theme-classic.md               |   0
 .../api/themes/theme-configuration.md         |  43 ++++-
 .../api/themes/theme-live-codeblock.md        |   0
 .../api/themes/theme-search-algolia.md        |   0
 .../docusaurus-asset-example-banner.png       | Bin
 .../assets/docusaurus-asset-example-pdf.pdf   | Bin
 .../assets/docusaurus-asset-example.xyz       | Bin
 .../blog.mdx                                  | 148 +++++++++++++++---
 .../browser-support.md                        |   0
 .../cli.md                                    |   8 +-
 .../configuration.md                          |   0
 .../deployment.mdx                            |  14 +-
 .../docusaurus-core.md                        |  10 ++
 .../guides/creating-pages.md                  |   2 +-
 .../guides/docs/docs-create-doc.mdx           |  26 ++-
 .../guides/docs/docs-introduction.md          |   0
 .../guides/docs/docs-markdown-features.mdx    |   0
 .../guides/docs/docs-multi-instance.mdx       |   0
 .../guides/docs/sidebar.md                    |   7 +-
 .../guides/docs/versioning.md                 |   0
 .../_markdown-partial-example.mdx             |   0
 .../markdown-features-admonitions.mdx         |  30 ++--
 .../markdown-features-assets.mdx              |   2 +-
 .../markdown-features-code-blocks.mdx         |  79 +++++++---
 .../markdown-features-head-metadatas.mdx      |   0
 .../markdown-features-headings.mdx            |   0
 .../markdown-features-inline-toc.mdx          |   5 +-
 .../markdown-features-intro.mdx               |   0
 .../markdown-features-math-equations.mdx      |   0
 .../markdown-features-plugins.mdx             |   0
 .../markdown-features-react.mdx               |   4 +-
 .../markdown-features-tabs.mdx                |  42 +++--
 .../i18n/i18n-crowdin.mdx                     |  12 +-
 .../i18n/i18n-git.md                          |   0
 .../i18n/i18n-introduction.md                 |   0
 .../i18n/i18n-tutorial.md                     |   0
 .../installation.md                           |  14 +-
 .../introduction.md                           |   2 +-
 .../lifecycle-apis.md                         |  13 +-
 .../migration/migration-automated.md          |   0
 .../migration/migration-manual.md             |   1 +
 .../migration/migration-overview.md           |   2 +-
 .../migration/migration-translated-sites.md   |   0
 .../migration/migration-versioned-sites.md    |   0
 .../playground.mdx                            |   0
 .../presets.md                                |  67 ++------
 .../search.md                                 | 117 +++++++++++---
 .../static-assets.md                          |   0
 .../styling-layout.md                         |   0
 .../typescript-support.md                     |  34 ++--
 .../using-plugins.md                          |   2 +-
 .../using-themes.md                           |   2 +-
 ...son => version-2.0.0-beta.8-sidebars.json} | 130 ++++++++-------
 website/versions.json                         |   4 +-
 website/versionsArchived.json                 |   3 +-
 105 files changed, 755 insertions(+), 468 deletions(-)
 delete mode 100644 website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-bootstrap.md
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/_partials/swizzleWarning.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/docusaurus.config.js.md (99%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/overview.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-client-redirects.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-content-blog.md (91%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-content-docs.md (93%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-content-pages.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-debug.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-google-analytics.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-google-gtag.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-ideal-image.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-pwa.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/plugins/plugin-sitemap.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/themes/overview.md (94%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/themes/theme-classic.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/themes/theme-configuration.md (95%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/themes/theme-live-codeblock.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/api/themes/theme-search-algolia.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/assets/docusaurus-asset-example-banner.png (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/assets/docusaurus-asset-example-pdf.pdf (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/assets/docusaurus-asset-example.xyz (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/blog.mdx (77%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/browser-support.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/cli.md (95%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/configuration.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/deployment.mdx (99%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/docusaurus-core.md (98%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/creating-pages.md (98%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/docs/docs-create-doc.mdx (75%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/docs/docs-introduction.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/docs/docs-markdown-features.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/docs/docs-multi-instance.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/docs/sidebar.md (98%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/docs/versioning.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/_markdown-partial-example.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-admonitions.mdx (72%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-assets.mdx (97%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-code-blocks.mdx (86%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-head-metadatas.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-headings.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-inline-toc.mdx (90%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-intro.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-math-equations.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-plugins.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-react.mdx (94%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/guides/markdown-features/markdown-features-tabs.mdx (78%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/i18n/i18n-crowdin.mdx (98%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/i18n/i18n-git.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/i18n/i18n-introduction.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/i18n/i18n-tutorial.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/installation.md (89%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/introduction.md (99%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/lifecycle-apis.md (99%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/migration/migration-automated.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/migration/migration-manual.md (99%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/migration/migration-overview.md (96%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/migration/migration-translated-sites.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/migration/migration-versioned-sites.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/playground.mdx (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/presets.md (66%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/search.md (55%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/static-assets.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/styling-layout.md (100%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/typescript-support.md (85%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/using-plugins.md (99%)
 rename website/versioned_docs/{version-2.0.0-beta.6 => version-2.0.0-beta.8}/using-themes.md (99%)
 rename website/versioned_sidebars/{version-2.0.0-beta.6-sidebars.json => version-2.0.0-beta.8-sidebars.json} (55%)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b7612b54a2..34c46bc8d7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,85 @@
 # Docusaurus 2 Changelog
 
+## 2.0.0-beta.8 (2021-10-21)
+
+#### :rocket: New Feature
+
+- `docusaurus-plugin-content-blog`
+  - [#5702](https://github.com/facebook/docusaurus/pull/5702) feat(content-blog): new readingTime plugin option ([@Josh-Cena](https://github.com/Josh-Cena))
+- `docusaurus`
+  - [#5740](https://github.com/facebook/docusaurus/pull/5740) feat(core): write-heading-ids options maintainCasing, overwrite ([@Josh-Cena](https://github.com/Josh-Cena))
+- `docusaurus-plugin-content-docs`
+  - [#5705](https://github.com/facebook/docusaurus/pull/5705) feat(content-docs): new front matter options to customize pagination ([@Josh-Cena](https://github.com/Josh-Cena))
+
+#### :boom: Breaking Change
+
+- `docusaurus-theme-search-algolia`
+  - [#5751](https://github.com/facebook/docusaurus/pull/5751) fix: stable callbacks in useSearchQuery + refactor ([@slorber](https://github.com/slorber))
+
+#### :bug: Bug Fix
+
+- `docusaurus-plugin-ideal-image`
+  - [#5760](https://github.com/facebook/docusaurus/pull/5760) fix(ideal-image): fix IdealImage in dev not handling ES import images properly ([@slorber](https://github.com/slorber))
+- `docusaurus-theme-classic`
+  - [#5732](https://github.com/facebook/docusaurus/pull/5732) fix(theme-classic): allow tabs with number as value ([@Josh-Cena](https://github.com/Josh-Cena))
+  - [#5721](https://github.com/facebook/docusaurus/pull/5721) fix: handle rubber band scrolling in hideable navbar ([@lex111](https://github.com/lex111))
+- `docusaurus-theme-search-algolia`
+  - [#5751](https://github.com/facebook/docusaurus/pull/5751) fix: stable callbacks in useSearchQuery + refactor ([@slorber](https://github.com/slorber))
+
+#### :nail_care: Polish
+
+- `docusaurus-theme-classic`
+  - [#5717](https://github.com/facebook/docusaurus/pull/5717) refactor: Polish de translation ([@philipp985](https://github.com/philipp985))
+  - [#5725](https://github.com/facebook/docusaurus/pull/5725) refactor: add missing Turkish translations to theme-classic ([@canercanbaz](https://github.com/canercanbaz))
+  - [#5723](https://github.com/facebook/docusaurus/pull/5723) refactor(v2): update Vietnamese translations ([@datlechin](https://github.com/datlechin))
+- `docusaurus-module-type-aliases`, `docusaurus-plugin-ideal-image`, `docusaurus-theme-classic`, `docusaurus`
+  - [#5726](https://github.com/facebook/docusaurus/pull/5726) refactor(module-type-aliases): remove fallback aliases ([@Josh-Cena](https://github.com/Josh-Cena))
+
+#### :memo: Documentation
+
+- Other
+  - [#5755](https://github.com/facebook/docusaurus/pull/5755) docs: rename docusaurus.config.js route + redirects cleanup ([@slorber](https://github.com/slorber))
+  - [#5750](https://github.com/facebook/docusaurus/pull/5750) docs(v2): Fix typo in using-plugins.md ([@thanasis00](https://github.com/thanasis00))
+  - [#5727](https://github.com/facebook/docusaurus/pull/5727) docs(v2): Add Fenghua Frontend Developer site to showcase page ([@zxuqian](https://github.com/zxuqian))
+  - [#5746](https://github.com/facebook/docusaurus/pull/5746) docs: Add plugin-image-zoom ([@ataft](https://github.com/ataft))
+  - [#5728](https://github.com/facebook/docusaurus/pull/5728) docs: add h4 into toc on certain pages ([@Josh-Cena](https://github.com/Josh-Cena))
+  - [#5737](https://github.com/facebook/docusaurus/pull/5737) docs: Add Apex FP to showcase ([@ipavlic](https://github.com/ipavlic))
+- `docusaurus-plugin-content-blog`
+  - [#5753](https://github.com/facebook/docusaurus/pull/5753) fix(content-blog): temporarily swallow feed mdxToHtml errors + feed refactor ([@slorber](https://github.com/slorber))
+
+#### :house: Internal
+
+- `docusaurus`
+  - [#5761](https://github.com/facebook/docusaurus/pull/5761) chore: upgrade html-webpack-plugin, remove terser 4 ([@slorber](https://github.com/slorber))
+- `docusaurus-theme-classic`, `docusaurus-theme-common`, `docusaurus-theme-search-algolia`, `docusaurus`
+  - [#5714](https://github.com/facebook/docusaurus/pull/5714) chore: Enable ESLint rules of hooks + fix new lint errors ([@slorber](https://github.com/slorber))
+- Other
+  - [#5722](https://github.com/facebook/docusaurus/pull/5722) chore: fix gen script to support TS template ([@lex111](https://github.com/lex111))
+  - [#5730](https://github.com/facebook/docusaurus/pull/5730) chore: fix typos / casing in issue template ([@johnnyreilly](https://github.com/johnnyreilly))
+  - [#5720](https://github.com/facebook/docusaurus/pull/5720) chore: regenerate beta.7 examples ([@lex111](https://github.com/lex111))
+  - [#5719](https://github.com/facebook/docusaurus/pull/5719) chore: remove beta.5 docs ([@lex111](https://github.com/lex111))
+
+#### :running_woman: Performance
+
+- `docusaurus`
+  - [#5748](https://github.com/facebook/docusaurus/pull/5748) refactor: perform shallow clone during deploy ([@nlfurniss](https://github.com/nlfurniss))
+
+#### Committers: 13
+
+- Alexey Pyltsyn ([@lex111](https://github.com/lex111))
+- Andrew Taft ([@ataft](https://github.com/ataft))
+- Caner Canbaz ([@canercanbaz](https://github.com/canercanbaz))
+- Dimi Mikadze ([@DimiMikadze](https://github.com/DimiMikadze))
+- Ilija Pavlic ([@ipavlic](https://github.com/ipavlic))
+- John Reilly ([@johnnyreilly](https://github.com/johnnyreilly))
+- Joshua Chen ([@Josh-Cena](https://github.com/Josh-Cena))
+- Nathaniel Furniss ([@nlfurniss](https://github.com/nlfurniss))
+- Ngô Quốc Đạt ([@datlechin](https://github.com/datlechin))
+- Sébastien Lorber ([@slorber](https://github.com/slorber))
+- Thanasis Katsadas ([@thanasis00](https://github.com/thanasis00))
+- Xuqian ([@zxuqian](https://github.com/zxuqian))
+- [@philipp985](https://github.com/philipp985)
+
 ## 2.0.0-beta.7 (2021-10-15)
 
 #### :rocket: New Feature
diff --git a/admin/new.docusaurus.io/package.json b/admin/new.docusaurus.io/package.json
index 4ca5b66c70..df4980850d 100644
--- a/admin/new.docusaurus.io/package.json
+++ b/admin/new.docusaurus.io/package.json
@@ -1,6 +1,6 @@
 {
   "name": "new.docusaurus.io",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "private": true,
   "scripts": {
     "start": "netlify dev"
diff --git a/lerna.json b/lerna.json
index 0f2cae777f..c59848a186 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "npmClient": "yarn",
   "useWorkspaces": true,
   "changelog": {
diff --git a/packages/create-docusaurus/package.json b/packages/create-docusaurus/package.json
index 507737cb53..5b62bf2803 100755
--- a/packages/create-docusaurus/package.json
+++ b/packages/create-docusaurus/package.json
@@ -1,6 +1,6 @@
 {
   "name": "create-docusaurus",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Create Docusaurus apps easily.",
   "repository": {
     "type": "git",
diff --git a/packages/create-docusaurus/templates/classic-typescript/package.json b/packages/create-docusaurus/templates/classic-typescript/package.json
index 3089140f82..0df788d225 100644
--- a/packages/create-docusaurus/templates/classic-typescript/package.json
+++ b/packages/create-docusaurus/templates/classic-typescript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-2-classic-typescript-template",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -15,8 +15,8 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/preset-classic": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/preset-classic": "2.0.0-beta.8",
     "@mdx-js/react": "^1.6.21",
     "@svgr/webpack": "^5.5.0",
     "clsx": "^1.1.1",
@@ -27,7 +27,7 @@
     "url-loader": "^4.1.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "2.0.0-beta.7",
+    "@docusaurus/module-type-aliases": "2.0.0-beta.8",
     "@tsconfig/docusaurus": "^1.0.4",
     "typescript": "^4.3.5"
   },
diff --git a/packages/create-docusaurus/templates/classic/package.json b/packages/create-docusaurus/templates/classic/package.json
index 1edb6021f8..257f2672be 100644
--- a/packages/create-docusaurus/templates/classic/package.json
+++ b/packages/create-docusaurus/templates/classic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-2-classic-template",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -14,8 +14,8 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/preset-classic": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/preset-classic": "2.0.0-beta.8",
     "@mdx-js/react": "^1.6.21",
     "@svgr/webpack": "^5.5.0",
     "clsx": "^1.1.1",
diff --git a/packages/create-docusaurus/templates/facebook/package.json b/packages/create-docusaurus/templates/facebook/package.json
index e35f27e4a9..0ac930a907 100644
--- a/packages/create-docusaurus/templates/facebook/package.json
+++ b/packages/create-docusaurus/templates/facebook/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-2-facebook-template",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -18,8 +18,8 @@
     "prettier:diff": "prettier --config .prettierrc --list-different \"**/*.{js,jsx,ts,tsx,md,mdx}\""
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/preset-classic": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/preset-classic": "2.0.0-beta.8",
     "@mdx-js/react": "^1.6.21",
     "@svgr/webpack": "^5.5.0",
     "clsx": "^1.1.1",
diff --git a/packages/docusaurus-cssnano-preset/package.json b/packages/docusaurus-cssnano-preset/package.json
index e94b31c56f..44965c05a3 100644
--- a/packages/docusaurus-cssnano-preset/package.json
+++ b/packages/docusaurus-cssnano-preset/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/cssnano-preset",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Advanced cssnano preset for maximum optimization.",
   "main": "index.js",
   "license": "MIT",
diff --git a/packages/docusaurus-mdx-loader/package.json b/packages/docusaurus-mdx-loader/package.json
index debde5f8be..8662df2cb4 100644
--- a/packages/docusaurus-mdx-loader/package.json
+++ b/packages/docusaurus-mdx-loader/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/mdx-loader",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Docusaurus Loader for MDX",
   "main": "lib/index.js",
   "types": "src/types.d.ts",
@@ -20,8 +20,8 @@
   "dependencies": {
     "@babel/parser": "^7.12.16",
     "@babel/traverse": "^7.12.13",
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
     "@mdx-js/mdx": "^1.6.21",
     "@mdx-js/react": "^1.6.21",
     "chalk": "^4.1.2",
@@ -38,7 +38,7 @@
     "webpack": "^5.40.0"
   },
   "devDependencies": {
-    "@docusaurus/types": "2.0.0-beta.7",
+    "@docusaurus/types": "2.0.0-beta.8",
     "@types/escape-html": "^1.0.1",
     "@types/mdast": "^3.0.7",
     "@types/stringify-object": "^3.3.1",
diff --git a/packages/docusaurus-migrate/package.json b/packages/docusaurus-migrate/package.json
index 1bfb454a7e..d5c215f70d 100644
--- a/packages/docusaurus-migrate/package.json
+++ b/packages/docusaurus-migrate/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/migrate",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "A CLI tool to migrate from older versions of Docusaurus.",
   "main": "lib/index.js",
   "license": "MIT",
diff --git a/packages/docusaurus-module-type-aliases/package.json b/packages/docusaurus-module-type-aliases/package.json
index 1e261a2de8..bbc02b928a 100644
--- a/packages/docusaurus-module-type-aliases/package.json
+++ b/packages/docusaurus-module-type-aliases/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/module-type-aliases",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Docusaurus module type aliases.",
   "types": "./src/index.d.ts",
   "publishConfig": {
diff --git a/packages/docusaurus-plugin-client-redirects/package.json b/packages/docusaurus-plugin-client-redirects/package.json
index 10312d004c..fe4f2b2c29 100644
--- a/packages/docusaurus-plugin-client-redirects/package.json
+++ b/packages/docusaurus-plugin-client-redirects/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-client-redirects",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Client redirects plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-client-redirects.d.ts",
@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-common": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-common": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "chalk": "^4.1.2",
     "eta": "^1.12.3",
     "fs-extra": "^10.0.0",
diff --git a/packages/docusaurus-plugin-content-blog/package.json b/packages/docusaurus-plugin-content-blog/package.json
index 791f13e896..d75f9df3de 100644
--- a/packages/docusaurus-plugin-content-blog/package.json
+++ b/packages/docusaurus-plugin-content-blog/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-blog",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Blog plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-blog.d.ts",
@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/mdx-loader": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/mdx-loader": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "chalk": "^4.1.2",
     "escape-string-regexp": "^4.0.0",
     "feed": "^4.2.2",
diff --git a/packages/docusaurus-plugin-content-docs/package.json b/packages/docusaurus-plugin-content-docs/package.json
index f1d89e62ca..3196262b2a 100644
--- a/packages/docusaurus-plugin-content-docs/package.json
+++ b/packages/docusaurus-plugin-content-docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-docs",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Docs plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-docs.d.ts",
@@ -18,7 +18,7 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "2.0.0-beta.7",
+    "@docusaurus/module-type-aliases": "2.0.0-beta.8",
     "@types/js-yaml": "^4.0.0",
     "@types/picomatch": "^2.2.1",
     "commander": "^5.1.0",
@@ -26,11 +26,11 @@
     "utility-types": "^3.10.0"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/mdx-loader": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/mdx-loader": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "chalk": "^4.1.2",
     "combine-promises": "^1.1.0",
     "escape-string-regexp": "^4.0.0",
diff --git a/packages/docusaurus-plugin-content-pages/package.json b/packages/docusaurus-plugin-content-pages/package.json
index ce4b703ebb..9115ae5d93 100644
--- a/packages/docusaurus-plugin-content-pages/package.json
+++ b/packages/docusaurus-plugin-content-pages/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-pages",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Pages plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-pages.d.ts",
@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/mdx-loader": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/mdx-loader": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "globby": "^11.0.2",
     "lodash": "^4.17.20",
     "remark-admonitions": "^1.2.1",
diff --git a/packages/docusaurus-plugin-debug/package.json b/packages/docusaurus-plugin-debug/package.json
index 9210d6812d..69146690e1 100644
--- a/packages/docusaurus-plugin-debug/package.json
+++ b/packages/docusaurus-plugin-debug/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-debug",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Debug plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/types.d.ts",
@@ -18,9 +18,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
     "fs-extra": "^10.0.0",
     "react-json-view": "^1.21.3",
     "tslib": "^2.3.1"
diff --git a/packages/docusaurus-plugin-google-analytics/package.json b/packages/docusaurus-plugin-google-analytics/package.json
index 85711cafa2..9f7ab26e0e 100644
--- a/packages/docusaurus-plugin-google-analytics/package.json
+++ b/packages/docusaurus-plugin-google-analytics/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-google-analytics",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Global analytics (analytics.js) plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-google-analytics.d.ts",
@@ -18,10 +18,10 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7"
+    "@docusaurus/core": "2.0.0-beta.8"
   },
   "devDependencies": {
-    "@docusaurus/types": "2.0.0-beta.7"
+    "@docusaurus/types": "2.0.0-beta.8"
   },
   "peerDependencies": {
     "react": "^16.8.4 || ^17.0.0",
diff --git a/packages/docusaurus-plugin-google-gtag/package.json b/packages/docusaurus-plugin-google-gtag/package.json
index 7b10cf5d4a..13e8bd955a 100644
--- a/packages/docusaurus-plugin-google-gtag/package.json
+++ b/packages/docusaurus-plugin-google-gtag/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-google-gtag",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Global Site Tag (gtag.js) plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-google-gtag.d.ts",
@@ -18,10 +18,10 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7"
+    "@docusaurus/core": "2.0.0-beta.8"
   },
   "devDependencies": {
-    "@docusaurus/types": "2.0.0-beta.7"
+    "@docusaurus/types": "2.0.0-beta.8"
   },
   "peerDependencies": {
     "react": "^16.8.4 || ^17.0.0",
diff --git a/packages/docusaurus-plugin-ideal-image/package.json b/packages/docusaurus-plugin-ideal-image/package.json
index 37e3dbba8f..0c9c0fe99c 100644
--- a/packages/docusaurus-plugin-ideal-image/package.json
+++ b/packages/docusaurus-plugin-ideal-image/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-ideal-image",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Docusaurus Plugin to generate an almost ideal image (responsive, lazy-loading, and low quality placeholder).",
   "main": "lib/index.js",
   "types": "src/plugin-ideal-image.d.ts",
@@ -21,10 +21,10 @@
     "fs-extra": "^10.0.0"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/lqip-loader": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/lqip-loader": "2.0.0-beta.8",
     "@docusaurus/responsive-loader": "1.4.0",
-    "@docusaurus/types": "2.0.0-beta.7",
+    "@docusaurus/types": "2.0.0-beta.8",
     "@endiliey/react-ideal-image": "^0.0.11",
     "react-waypoint": "^10.1.0",
     "sharp": "^0.29.1",
diff --git a/packages/docusaurus-plugin-pwa/package.json b/packages/docusaurus-plugin-pwa/package.json
index cacecbc603..9a9adfb0b3 100644
--- a/packages/docusaurus-plugin-pwa/package.json
+++ b/packages/docusaurus-plugin-pwa/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-pwa",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Docusaurus Plugin to add PWA support.",
   "main": "src/index.js",
   "publishConfig": {
@@ -16,10 +16,10 @@
     "@babel/plugin-proposal-nullish-coalescing-operator": "^7.12.13",
     "@babel/plugin-proposal-optional-chaining": "^7.12.16",
     "@babel/preset-env": "^7.15.6",
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/theme-common": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/theme-common": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "babel-loader": "^8.2.2",
     "clsx": "^1.1.1",
     "core-js": "^2.6.5",
diff --git a/packages/docusaurus-plugin-sitemap/package.json b/packages/docusaurus-plugin-sitemap/package.json
index a4e78129ff..55294198b2 100644
--- a/packages/docusaurus-plugin-sitemap/package.json
+++ b/packages/docusaurus-plugin-sitemap/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-sitemap",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Simple sitemap generation plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-sitemap.d.ts",
@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-common": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-common": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "fs-extra": "^10.0.0",
     "sitemap": "^7.0.0",
     "tslib": "^2.3.1"
diff --git a/packages/docusaurus-preset-classic/package.json b/packages/docusaurus-preset-classic/package.json
index 7e4dadc6ac..7bf4969b65 100644
--- a/packages/docusaurus-preset-classic/package.json
+++ b/packages/docusaurus-preset-classic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/preset-classic",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Classic preset for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/preset-classic.d.ts",
@@ -18,16 +18,16 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-blog": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-docs": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-pages": "2.0.0-beta.7",
-    "@docusaurus/plugin-debug": "2.0.0-beta.7",
-    "@docusaurus/plugin-google-analytics": "2.0.0-beta.7",
-    "@docusaurus/plugin-google-gtag": "2.0.0-beta.7",
-    "@docusaurus/plugin-sitemap": "2.0.0-beta.7",
-    "@docusaurus/theme-classic": "2.0.0-beta.7",
-    "@docusaurus/theme-search-algolia": "2.0.0-beta.7"
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-blog": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-docs": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-pages": "2.0.0-beta.8",
+    "@docusaurus/plugin-debug": "2.0.0-beta.8",
+    "@docusaurus/plugin-google-analytics": "2.0.0-beta.8",
+    "@docusaurus/plugin-google-gtag": "2.0.0-beta.8",
+    "@docusaurus/plugin-sitemap": "2.0.0-beta.8",
+    "@docusaurus/theme-classic": "2.0.0-beta.8",
+    "@docusaurus/theme-search-algolia": "2.0.0-beta.8"
   },
   "peerDependencies": {
     "react": "^16.8.4 || ^17.0.0",
diff --git a/packages/docusaurus-remark-plugin-npm2yarn/package.json b/packages/docusaurus-remark-plugin-npm2yarn/package.json
index b9003a92ee..6ab516482a 100644
--- a/packages/docusaurus-remark-plugin-npm2yarn/package.json
+++ b/packages/docusaurus-remark-plugin-npm2yarn/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/remark-plugin-npm2yarn",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Remark plugin for converting npm commands to Yarn commands as tabs.",
   "main": "src/index.js",
   "publishConfig": {
diff --git a/packages/docusaurus-theme-classic/package.json b/packages/docusaurus-theme-classic/package.json
index 14bf990f23..faf718bc8f 100644
--- a/packages/docusaurus-theme-classic/package.json
+++ b/packages/docusaurus-theme-classic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-classic",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Classic theme for Docusaurus",
   "main": "lib/index.js",
   "types": "src/types.d.ts",
@@ -23,15 +23,15 @@
     "update-code-translations": "node -e 'require(\"./update-code-translations.js\").run()'"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-blog": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-docs": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-pages": "2.0.0-beta.7",
-    "@docusaurus/theme-common": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-common": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-blog": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-docs": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-pages": "2.0.0-beta.8",
+    "@docusaurus/theme-common": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-common": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "@mdx-js/mdx": "^1.6.21",
     "@mdx-js/react": "^1.6.21",
     "chalk": "^4.1.2",
@@ -50,7 +50,7 @@
     "rtlcss": "^3.3.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "2.0.0-beta.7",
+    "@docusaurus/module-type-aliases": "2.0.0-beta.8",
     "@types/mdx-js__react": "^1.5.4",
     "@types/parse-numeric-range": "^0.0.1",
     "@types/rtlcss": "^3.1.1",
diff --git a/packages/docusaurus-theme-common/package.json b/packages/docusaurus-theme-common/package.json
index 52157559ec..2bc7a79733 100644
--- a/packages/docusaurus-theme-common/package.json
+++ b/packages/docusaurus-theme-common/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-common",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Common code for Docusaurus themes.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,18 +18,18 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-blog": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-docs": "2.0.0-beta.7",
-    "@docusaurus/plugin-content-pages": "2.0.0-beta.7",
-    "@docusaurus/types": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-blog": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-docs": "2.0.0-beta.8",
+    "@docusaurus/plugin-content-pages": "2.0.0-beta.8",
+    "@docusaurus/types": "2.0.0-beta.8",
     "clsx": "^1.1.1",
     "fs-extra": "^10.0.0",
     "tslib": "^2.3.1",
     "utility-types": "^3.10.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "2.0.0-beta.7",
+    "@docusaurus/module-type-aliases": "2.0.0-beta.8",
     "lodash": "^4.17.20"
   },
   "peerDependencies": {
diff --git a/packages/docusaurus-theme-live-codeblock/package.json b/packages/docusaurus-theme-live-codeblock/package.json
index 517460f58f..293046ab89 100644
--- a/packages/docusaurus-theme-live-codeblock/package.json
+++ b/packages/docusaurus-theme-live-codeblock/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-live-codeblock",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Docusaurus live code block component.",
   "main": "src/index.js",
   "publishConfig": {
@@ -13,8 +13,8 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "@philpl/buble": "^0.19.7",
     "clsx": "^1.1.1",
     "parse-numeric-range": "^1.3.0",
diff --git a/packages/docusaurus-theme-search-algolia/package.json b/packages/docusaurus-theme-search-algolia/package.json
index c4681f522e..6dda70cec9 100644
--- a/packages/docusaurus-theme-search-algolia/package.json
+++ b/packages/docusaurus-theme-search-algolia/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-search-algolia",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Algolia search component for Docusaurus.",
   "main": "src/index.js",
   "publishConfig": {
@@ -14,10 +14,10 @@
   "license": "MIT",
   "dependencies": {
     "@docsearch/react": "^3.0.0-alpha.39",
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/theme-common": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/theme-common": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "algoliasearch": "^4.10.5",
     "algoliasearch-helper": "^3.5.5",
     "clsx": "^1.1.1",
diff --git a/packages/docusaurus-types/package.json b/packages/docusaurus-types/package.json
index 0b42034457..24a00f2f4a 100644
--- a/packages/docusaurus-types/package.json
+++ b/packages/docusaurus-types/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/types",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Common types for Docusaurus packages.",
   "types": "./src/index.d.ts",
   "publishConfig": {
diff --git a/packages/docusaurus-utils-common/package.json b/packages/docusaurus-utils-common/package.json
index 5edf47a0b2..5a3cfba535 100644
--- a/packages/docusaurus-utils-common/package.json
+++ b/packages/docusaurus-utils-common/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/utils-common",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Common (Node/Browser) utility functions for Docusaurus packages.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,7 +18,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/types": "2.0.0-beta.7",
+    "@docusaurus/types": "2.0.0-beta.8",
     "tslib": "^2.3.1"
   },
   "engines": {
diff --git a/packages/docusaurus-utils-validation/package.json b/packages/docusaurus-utils-validation/package.json
index b75b1b77ee..cfca039640 100644
--- a/packages/docusaurus-utils-validation/package.json
+++ b/packages/docusaurus-utils-validation/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/utils-validation",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Node validation utility functions for Docusaurus packages.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,7 +18,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/utils": "2.0.0-beta.7",
+    "@docusaurus/utils": "2.0.0-beta.8",
     "chalk": "^4.1.2",
     "joi": "^17.4.2",
     "tslib": "^2.3.1"
diff --git a/packages/docusaurus-utils/package.json b/packages/docusaurus-utils/package.json
index 94e45dfe70..f1d257417d 100644
--- a/packages/docusaurus-utils/package.json
+++ b/packages/docusaurus-utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/utils",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Node utility functions for Docusaurus packages.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,7 +18,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/types": "2.0.0-beta.7",
+    "@docusaurus/types": "2.0.0-beta.8",
     "@mdx-js/runtime": "^1.6.22",
     "@types/github-slugger": "^1.3.0",
     "chalk": "^4.1.2",
diff --git a/packages/docusaurus/package.json b/packages/docusaurus/package.json
index 3b92a32079..939c72d33e 100644
--- a/packages/docusaurus/package.json
+++ b/packages/docusaurus/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -31,7 +31,7 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "2.0.0-beta.7",
+    "@docusaurus/module-type-aliases": "2.0.0-beta.8",
     "@types/copy-webpack-plugin": "^8.0.1",
     "@types/css-minimizer-webpack-plugin": "^3.0.2",
     "@types/detect-port": "^1.3.0",
@@ -55,12 +55,12 @@
     "@babel/runtime": "^7.15.4",
     "@babel/runtime-corejs3": "^7.15.4",
     "@babel/traverse": "^7.12.13",
-    "@docusaurus/cssnano-preset": "2.0.0-beta.7",
+    "@docusaurus/cssnano-preset": "2.0.0-beta.8",
     "@docusaurus/react-loadable": "5.5.0",
-    "@docusaurus/types": "2.0.0-beta.7",
-    "@docusaurus/utils": "2.0.0-beta.7",
-    "@docusaurus/utils-common": "2.0.0-beta.7",
-    "@docusaurus/utils-validation": "2.0.0-beta.7",
+    "@docusaurus/types": "2.0.0-beta.8",
+    "@docusaurus/utils": "2.0.0-beta.8",
+    "@docusaurus/utils-common": "2.0.0-beta.8",
+    "@docusaurus/utils-validation": "2.0.0-beta.8",
     "@slorber/static-site-generator-webpack-plugin": "^4.0.0",
     "@svgr/webpack": "^5.5.0",
     "autoprefixer": "^10.3.5",
diff --git a/packages/lqip-loader/package.json b/packages/lqip-loader/package.json
index cf2cc82cdf..d1a030c326 100644
--- a/packages/lqip-loader/package.json
+++ b/packages/lqip-loader/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/lqip-loader",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Low Quality Image Placeholders (LQIP) loader for webpack.",
   "main": "src/index.js",
   "publishConfig": {
diff --git a/packages/stylelint-copyright/package.json b/packages/stylelint-copyright/package.json
index 2c941fed10..8166ec55a9 100644
--- a/packages/stylelint-copyright/package.json
+++ b/packages/stylelint-copyright/package.json
@@ -1,6 +1,6 @@
 {
   "name": "stylelint-copyright",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Stylelint plugin to check CSS files for a copyright header.",
   "main": "index.js",
   "license": "MIT",
diff --git a/website/package.json b/website/package.json
index 67c76bd829..3ff20c497b 100644
--- a/website/package.json
+++ b/website/package.json
@@ -1,6 +1,6 @@
 {
   "name": "website",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -31,13 +31,13 @@
   "dependencies": {
     "@crowdin/cli": "^3.5.2",
     "@crowdin/crowdin-api-client": "^1.10.6",
-    "@docusaurus/core": "2.0.0-beta.7",
-    "@docusaurus/plugin-client-redirects": "2.0.0-beta.7",
-    "@docusaurus/plugin-ideal-image": "2.0.0-beta.7",
-    "@docusaurus/plugin-pwa": "2.0.0-beta.7",
-    "@docusaurus/preset-classic": "2.0.0-beta.7",
-    "@docusaurus/remark-plugin-npm2yarn": "2.0.0-beta.7",
-    "@docusaurus/theme-live-codeblock": "2.0.0-beta.7",
+    "@docusaurus/core": "2.0.0-beta.8",
+    "@docusaurus/plugin-client-redirects": "2.0.0-beta.8",
+    "@docusaurus/plugin-ideal-image": "2.0.0-beta.8",
+    "@docusaurus/plugin-pwa": "2.0.0-beta.8",
+    "@docusaurus/preset-classic": "2.0.0-beta.8",
+    "@docusaurus/remark-plugin-npm2yarn": "2.0.0-beta.8",
+    "@docusaurus/theme-live-codeblock": "2.0.0-beta.8",
     "clsx": "^1.1.1",
     "color": "^4.0.1",
     "esbuild-loader": "2.13.1",
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-bootstrap.md b/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-bootstrap.md
deleted file mode 100644
index 2c2dc05a62..0000000000
--- a/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-bootstrap.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-id: theme-bootstrap
-title: '📦 theme-bootstrap'
-slug: '/api/themes/@docusaurus/theme-bootstrap'
----
-
-:::danger
-
-The bootstrap theme is a work in progress, and is not production ready.
-
-:::
-
-🚧 The bootstrap theme for Docusaurus.
-
-You can refer to the [theme configuration page](theme-configuration.md) for more details on the configuration.
-
-```bash npm2yarn
-npm install --save @docusaurus/theme-bootstrap
-```
-
-:::tip
-
-If you have installed `@docusaurus/preset-bootstrap`, you don't need to install it as a dependency.
-
-:::
diff --git a/website/versioned_docs/version-2.0.0-beta.6/_partials/swizzleWarning.mdx b/website/versioned_docs/version-2.0.0-beta.8/_partials/swizzleWarning.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/_partials/swizzleWarning.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/_partials/swizzleWarning.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/docusaurus.config.js.md b/website/versioned_docs/version-2.0.0-beta.8/api/docusaurus.config.js.md
similarity index 99%
rename from website/versioned_docs/version-2.0.0-beta.6/api/docusaurus.config.js.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/docusaurus.config.js.md
index 21a5ba0ce1..a153a84910 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/api/docusaurus.config.js.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/api/docusaurus.config.js.md
@@ -1,7 +1,7 @@
 ---
 id: docusaurus.config.js
 description: API reference for Docusaurus configuration file.
-slug: /docusaurus.config.js
+slug: /api/docusaurus-config
 ---
 
 # `docusaurus.config.js`
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/overview.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/overview.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/overview.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/overview.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-client-redirects.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-client-redirects.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-client-redirects.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-client-redirects.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-blog.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-blog.md
similarity index 91%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-blog.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-blog.md
index 58af14d1dd..f769ab10b3 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-blog.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-blog.md
@@ -36,6 +36,7 @@ Accepted fields:
 | `blogSidebarCount` | <code>number \| 'ALL'</code> | `5` | Number of blog post elements to show in the blog sidebar. `'ALL'` to show all blog posts; `0` to disable |
 | `blogSidebarTitle` | `string` | `'Recent posts'` | Title of the blog sidebar. |
 | `routeBasePath` | `string` | `'blog'` | URL route for the blog section of your site. **DO NOT** include a trailing slash. Use `/` to put the blog at root path. |
+| `tagsBasePath` | `string` | `'tags'` | URL route for the tags list page of your site. It is prepended to the `routeBasePath`. |
 | `archiveBasePath` | `string` | `'/archive'` | URL route for the archive blog section of your site. It is prepended to the `routeBasePath`. **DO NOT** include a trailing slash. |
 | `include` | `string[]` | `['**/*.{md,mdx}']` | Matching files will be included and processed. |
 | `exclude` | `string[]` | _See example configuration_ | No route will be created for matching files. |
@@ -50,6 +51,7 @@ Accepted fields:
 | `beforeDefaultRehypePlugins` | `any[]` | `[]` | Custom Rehype plugins passed to MDX before the default Docusaurus Rehype plugins. |
 | `truncateMarker` | `string` | `/<!--\s*(truncate)\s*-->/` | Truncate marker, can be a regex or string. |
 | `showReadingTime` | `boolean` | `true` | Show estimated reading time for the blog post. |
+| `readingTime` | `ReadingTimeFunctionOption` | The default reading time | A callback to customize the reading time number displayed. |
 | `authorsMapPath` | `string` | `'authors.yml'` | Path to the authors map file, relative to the blog content directory specified with `path`. Can also be a `json` file. |
 | `feedOptions` | _See below_ | `{type: ['rss', 'atom']}` | Blog feed. If undefined, no rss feed will be generated. |
 | `feedOptions.type` | <code>'rss' \| 'atom' \| 'all'</code> (or array of multiple options) | **Required** | Type of feed to be generated. |
@@ -67,6 +69,23 @@ type EditUrlFunction = (params: {
   permalink: string;
   locale: string;
 }) => string | undefined;
+
+type ReadingTimeOptions = {
+  wordsPerMinute: number;
+  wordBound: (char: string) => boolean;
+};
+
+type ReadingTimeFunction = (params: {
+  content: string;
+  frontMatter?: BlogPostFrontMatter & Record<string, unknown>;
+  options?: ReadingTimeOptions;
+}) => number;
+
+type ReadingTimeFunctionOption = (params: {
+  content: string;
+  frontMatter: BlogPostFrontMatter & Record<string, unknown>;
+  defaultReadingTime: ReadingTimeFunction;
+}) => number | undefined;
 ```
 
 ## Example configuration {#ex-config}
@@ -186,6 +205,8 @@ Accepted fields:
 | `tags` | `Tag[]` | `undefined` | A list of strings or objects of two string fields `label` and `permalink` to tag to your post. |
 | `draft` | `boolean` | `false` | A boolean flag to indicate that the blog post is work-in-progress and therefore should not be published yet. However, draft blog posts will be displayed during development. |
 | `hide_table_of_contents` | `boolean` | `false` | Whether to hide the table of contents to the right. |
+| `toc_min_heading_level` | `number` | `2` | The minimum heading level shown in the table of contents. Must be between 2 and 6 and lower or equal to the max value. |
+| `toc_max_heading_level` | `number` | `3` | The max heading level shown in the table of contents. Must be between 2 and 6. |
 | `keywords` | `string[]` | `undefined` | Keywords meta tag, which will become the `<meta name="keywords" content="keyword1,keyword2,..."/>` in `<head>`, used by search engines. |
 | `description` | `string` | The first line of Markdown content | The description of your document, which will become the `<meta name="description" content="..."/>` and `<meta property="og:description" content="..."/>` in `<head>`, used by search engines. |
 | `image` | `string` | `undefined` | Cover or thumbnail image that will be used when displaying the link to your post. |
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-docs.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-docs.md
similarity index 93%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-docs.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-docs.md
index 0e947ab109..ab324d4a09 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-docs.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-docs.md
@@ -33,6 +33,7 @@ Accepted fields:
 | `editLocalizedFiles` | `boolean` | `false` | The edit URL will target the localized file, instead of the original unlocalized file. Ignored when `editUrl` is a function. |
 | `editCurrentVersion` | `boolean` | `false` | The edit URL will always target the current version doc instead of older versions. Ignored when `editUrl` is a function. |
 | `routeBasePath` | `string` | `'docs'` | URL route for the docs section of your site. **DO NOT** include a trailing slash. Use `/` for shipping docs without base path. |
+| `tagsBasePath` | `string` | `'tags'` | URL route for the tags list page of your site. It is prepended to the `routeBasePath`. |
 | `include` | `string[]` | `['**/*.{md,mdx}']` | Matching files will be included and processed. |
 | `exclude` | `string[]` | _See example configuration_ | No route will be created for matching files. |
 | `sidebarPath` | <code>false \| string</code> | `undefined` (creates autogenerated sidebar) | Path to sidebar configuration. |
@@ -246,8 +247,13 @@ Accepted fields:
 | `pagination_label` | `string` | `sidebar_label` or `title` | The text used in the document next/previous buttons for this document. |
 | `sidebar_label` | `string` | `title` | The text shown in the document sidebar for this document. |
 | `sidebar_position` | `number` | Default ordering | Controls the position of a doc inside the generated sidebar slice when using `autogenerated` sidebar items. See also [Autogenerated sidebar metadatas](/docs/sidebar#autogenerated-sidebar-metadatas). |
+| `sidebar_class_name` | `string` | `undefined` | Gives the corresponding sidebar label a special class name when using autogenerated sidebars. |
 | `hide_title` | `boolean` | `false` | Whether to hide the title at the top of the doc. It only hides a title declared through the frontmatter, and have no effect on a Markdown title at the top of your document. |
 | `hide_table_of_contents` | `boolean` | `false` | Whether to hide the table of contents to the right. |
+| `toc_min_heading_level` | `number` | `2` | The minimum heading level shown in the table of contents. Must be between 2 and 6 and lower or equal to the max value. |
+| `toc_max_heading_level` | `number` | `3` | The max heading level shown in the table of contents. Must be between 2 and 6. |
+| `pagination_next` | <code>string \| null</code> | Next doc in the sidebar | The ID of the documentation you want the "Next" pagination to link to. Use `null` to disable showing "Next" for this page. |
+| `pagination_prev` | <code>string \| null</code> | Previous doc in the sidebar | The ID of the documentation you want the "Previous" pagination to link to. Use `null` to disable showing "Previous" for this page. |
 | `parse_number_prefixes` | `boolean` | `numberPrefixParser` plugin option | Whether number prefix parsing is disabled on this doc. See also [Using number prefixes](/docs/sidebar#using-number-prefixes). |
 | `custom_edit_url` | `string` | Computed using the `editUrl` plugin option | The URL for editing this document. |
 | `keywords` | `string[]` | `undefined` | Keywords meta tag for the document page, for search engines. |
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-pages.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-pages.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-content-pages.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-content-pages.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-debug.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-debug.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-debug.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-debug.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-google-analytics.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-google-analytics.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-google-analytics.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-google-analytics.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-google-gtag.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-google-gtag.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-google-gtag.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-google-gtag.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-ideal-image.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-ideal-image.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-ideal-image.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-ideal-image.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-pwa.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-pwa.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-pwa.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-pwa.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-sitemap.md b/website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-sitemap.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/plugins/plugin-sitemap.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/plugins/plugin-sitemap.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/themes/overview.md b/website/versioned_docs/version-2.0.0-beta.8/api/themes/overview.md
similarity index 94%
rename from website/versioned_docs/version-2.0.0-beta.6/api/themes/overview.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/themes/overview.md
index 984918726f..8a2ee6b50f 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/api/themes/overview.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/api/themes/overview.md
@@ -12,7 +12,7 @@ We provide official Docusaurus themes.
 The main themes implement the user interface for the [docs](../plugins/plugin-content-docs.md), [blog](../plugins/plugin-content-blog.md) and [pages](../plugins/plugin-content-pages.md) plugins.
 
 - [@docusaurus/theme-classic](./theme-classic.md)
-- [@docusaurus/theme-bootstrap](./theme-bootstrap.md) 🚧
+- 🚧 other themes are planned
 
 :::caution
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-classic.md b/website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-classic.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-classic.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-classic.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-configuration.md b/website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-configuration.md
similarity index 95%
rename from website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-configuration.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-configuration.md
index c22cdbe652..72e4dc5f04 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-configuration.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-configuration.md
@@ -2,6 +2,7 @@
 id: theme-configuration
 title: 'Theme configuration'
 slug: '/api/themes/configuration'
+toc_max_heading_level: 4
 ---
 
 This configuration applies to all [main themes](./overview.md).
@@ -251,7 +252,7 @@ module.exports = {
 
 The items can have different behaviors based on the `type` field. The sections below will introduce you to all the types of navbar items available.
 
-### Navbar link {#navbar-link}
+#### Navbar link {#navbar-link}
 
 By default, Navbar items are regular links (internal or external).
 
@@ -306,7 +307,7 @@ module.exports = {
 };
 ```
 
-### Navbar dropdown {#navbar-dropdown}
+#### Navbar dropdown {#navbar-dropdown}
 
 Navbar items of the type `dropdown` has the additional `items` field, an inner array of navbar items.
 
@@ -362,7 +363,7 @@ module.exports = {
 };
 ```
 
-### Navbar doc link {#navbar-doc-link}
+#### Navbar doc link {#navbar-doc-link}
 
 If you want to link to a specific doc, this special navbar item type will render the link to the doc of the provided `docId`. It will get the class `navbar__link--active` as long as you browse a doc of the same sidebar.
 
@@ -400,7 +401,7 @@ module.exports = {
 };
 ```
 
-### Navbar docs version dropdown {#navbar-docs-version-dropdown}
+#### Navbar docs version dropdown {#navbar-docs-version-dropdown}
 
 If you use docs with versioning, this special navbar item type that will render a dropdown with all your site's available versions.
 
@@ -441,7 +442,7 @@ module.exports = {
 };
 ```
 
-### Navbar docs version {#navbar-docs-version}
+#### Navbar docs version {#navbar-docs-version}
 
 If you use docs with versioning, this special navbar item type will link to the active/browsed version of your doc (depends on the current URL), and fallback to the latest version.
 
@@ -479,7 +480,7 @@ module.exports = {
 };
 ```
 
-### Navbar locale dropdown {#navbar-locale-dropdown}
+#### Navbar locale dropdown {#navbar-locale-dropdown}
 
 If you use the [i18n feature](../../i18n/i18n-introduction.md), this special navbar item type will render a dropdown with all your site's available locales.
 
@@ -522,7 +523,7 @@ module.exports = {
 };
 ```
 
-### Navbar search {#navbar-search}
+#### Navbar search {#navbar-search}
 
 If you use the [search](../../search.md), the search bar will be the rightmost element in the navbar.
 
@@ -757,6 +758,34 @@ module.exports = {
 };
 ```
 
+## Table of Contents {#table-of-contents}
+
+You can adjust the default table of contents via `themeConfig.tableOfContents`.
+
+<small>
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `minHeadingLevel` | `number` | `2` | The minimum heading level shown in the table of contents. Must be between 2 and 6 and lower or equal to the max value. |
+| `maxHeadingLevel` | `number` | `3` | Max heading level displayed in the TOC. Should be an integer between 2 and 6. |
+
+</small>
+
+Example configuration:
+
+```js title="docusaurus.config.js"
+module.exports = {
+  themeConfig: {
+    // highlight-start
+    tableOfContents: {
+      minHeadingLevel: 2,
+      maxHeadingLevel: 5,
+    },
+    // highlight-end
+  },
+};
+```
+
 ## Hooks {#hooks}
 
 ### `useThemeContext` {#usethemecontext}
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-live-codeblock.md b/website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-live-codeblock.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-live-codeblock.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-live-codeblock.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-search-algolia.md b/website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-search-algolia.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/api/themes/theme-search-algolia.md
rename to website/versioned_docs/version-2.0.0-beta.8/api/themes/theme-search-algolia.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/assets/docusaurus-asset-example-banner.png b/website/versioned_docs/version-2.0.0-beta.8/assets/docusaurus-asset-example-banner.png
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/assets/docusaurus-asset-example-banner.png
rename to website/versioned_docs/version-2.0.0-beta.8/assets/docusaurus-asset-example-banner.png
diff --git a/website/versioned_docs/version-2.0.0-beta.6/assets/docusaurus-asset-example-pdf.pdf b/website/versioned_docs/version-2.0.0-beta.8/assets/docusaurus-asset-example-pdf.pdf
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/assets/docusaurus-asset-example-pdf.pdf
rename to website/versioned_docs/version-2.0.0-beta.8/assets/docusaurus-asset-example-pdf.pdf
diff --git a/website/versioned_docs/version-2.0.0-beta.6/assets/docusaurus-asset-example.xyz b/website/versioned_docs/version-2.0.0-beta.8/assets/docusaurus-asset-example.xyz
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/assets/docusaurus-asset-example.xyz
rename to website/versioned_docs/version-2.0.0-beta.8/assets/docusaurus-asset-example.xyz
diff --git a/website/versioned_docs/version-2.0.0-beta.6/blog.mdx b/website/versioned_docs/version-2.0.0-beta.8/blog.mdx
similarity index 77%
rename from website/versioned_docs/version-2.0.0-beta.6/blog.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/blog.mdx
index a028526023..171cc12c76 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/blog.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/blog.mdx
@@ -176,14 +176,8 @@ Use the `authors` FrontMatter field to declare blog post authors.
 Blog post authors can be declared directly inside the FrontMatter:
 
 ````mdx-code-block
-<Tabs
-  defaultValue="single"
-  values={[
-    {label: 'Single author', value: 'single'},
-    {label: 'Multiple authors', value: 'multiple'},
-  ]}
-  groupId="author-frontmatter">
-  <TabItem value="single">
+<Tabs groupId="author-frontmatter">
+  <TabItem value="single" label="Single author">
 
 ```yml title="my-blog-post.md"
 ---
@@ -196,7 +190,7 @@ authors:
 ```
 
   </TabItem>
-  <TabItem value="multiple">
+  <TabItem value="multiple" label="Multiple authors">
 
 ```yml title="my-blog-post.md"
 ---
@@ -226,7 +220,6 @@ This option works best to get started, or for casual, irregular authors.
 
 Prefer usage of the `authors` FrontMatter, but the legacy `author_*` FrontMatter remains supported:
 
-<!-- prettier-ignore-start -->
 ```yml title="my-blog-post.md"
 ---
 author: Joel Marcey
@@ -235,7 +228,6 @@ author_url: https://github.com/JoelMarcey
 author_image_url: https://github.com/JoelMarcey.png
 ---
 ```
-<!-- prettier-ignore-end -->
 
 :::
 
@@ -268,14 +260,8 @@ Use the `authorsMapPath` plugin option to configure the path. JSON is also suppo
 In blog posts FrontMatter, you can reference the authors declared in the global configuration file:
 
 ````mdx-code-block
-<Tabs
-  defaultValue="single"
-  values={[
-    {label: 'Single author', value: 'single'},
-    {label: 'Multiple authors', value: 'multiple'},
-  ]}
-  groupId="author-frontmatter">
-  <TabItem value="single">
+<Tabs groupId="author-frontmatter">
+  <TabItem value="single" label="Single author">
 
 ```yml title="my-blog-post.md"
 ---
@@ -284,7 +270,7 @@ authors: jmarcey
 ```
 
   </TabItem>
-  <TabItem value="multiple">
+  <TabItem value="multiple" label="Multiple authors">
 
 ```yml title="my-blog-post.md"
 ---
@@ -305,7 +291,6 @@ The `authors` system is very flexible and can suit more advanced use-case:
 
 You can use global authors most of the time, and still use inline authors:
 
-<!-- prettier-ignore-start -->
 ```yml title="my-blog-post.md"
 ---
 authors:
@@ -317,7 +302,6 @@ authors:
     image_url: https://github.com/inlineAuthor
 ---
 ```
-<!-- prettier-ignore-end -->
 
 </details>
 
@@ -326,7 +310,6 @@ authors:
 
 You can customize the global author's data on per-blog-post basis:
 
-<!-- prettier-ignore-start -->
 ```yml title="my-blog-post.md"
 ---
 authors:
@@ -336,7 +319,6 @@ authors:
     name: Sébastien Lorber's new name
 ---
 ```
-<!-- prettier-ignore-end -->
 
 </details>
 
@@ -353,6 +335,124 @@ website/i18n/<locale>/docusaurus-plugin-content-blog/authors.yml
 
 :::
 
+## Reading time {#reading-time}
+
+Docusaurus generates a reading time estimation for each blog post based on word count. We provide an option to customize this.
+
+```js title="docusaurus.config.js"
+module.exports = {
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        blog: {
+          // highlight-start
+          showReadingTime: true, // When set to false, the "x min read" won't be shown
+          readingTime: ({content, frontMatter, defaultReadingTime}) =>
+            defaultReadingTime({content, options: {wordsPerMinute: 300}}),
+          // highlight-end
+        },
+      },
+    ],
+  ],
+};
+```
+
+The `readingTime` callback receives three parameters: the blog content text as a string, front matter as a record of string keys and their values, and the default reading time function. It returns a number (reading time in minutes) or `undefined` (disable reading time for this page).
+
+The default reading time is able to accept additional options: `wordsPerMinute` as a number (default: 300), and `wordBound` as a function from string to boolean. If the string passed to `wordBound` should be a word bound (spaces, tabs, and line breaks by default), the function should return `true`.
+
+:::tip
+
+Use the callback for all your customization needs:
+
+````mdx-code-block
+<Tabs>
+<TabItem value="disable-per-post" label="Per-post disabling">
+
+**Disable reading time on one page:**
+
+```js title="docusaurus.config.js"
+module.exports = {
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        blog: {
+          showReadingTime: true,
+          // highlight-start
+          readingTime: ({content, frontMatter, defaultReadingTime}) =>
+            frontMatter.hide_reading_time ? undefined : defaultReadingTime({content}),
+          // highlight-end
+        },
+      },
+    ],
+  ],
+};
+```
+
+Usage:
+
+```yml "my-blog-post.md"
+---
+hide_reading_time: true
+---
+
+This page will no longer display the reading time stats!
+```
+
+</TabItem>
+<TabItem value="passing-options" label="Passing options">
+
+**Pass options to the default reading time function:**
+
+```js title="docusaurus.config.js"
+module.exports = {
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        blog: {
+          // highlight-start
+          readingTime: ({content, defaultReadingTime}) =>
+            defaultReadingTime({content, options: {wordsPerMinute: 100}}),
+          // highlight-end
+        },
+      },
+    ],
+  ],
+};
+```
+
+</TabItem>
+<TabItem value="using-custom-algo" label="Using custom algorithms">
+
+**Use a custom implementation of reading time:**
+
+```js title="docusaurus.config.js"
+const myReadingTime = require('./myReadingTime');
+
+module.exports = {
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        blog: {
+          // highlight-next-line
+          readingTime: ({content}) => myReadingTime(content),
+        },
+      },
+    ],
+  ],
+};
+```
+
+</TabItem>
+</Tabs>
+````
+
+:::
+
 ## Feed {#feed}
 
 You can generate RSS/Atom feed by passing feedOptions. By default, RSS and Atom feeds are generated. To disable feed generation, set `feedOptions.type` to `null`.
diff --git a/website/versioned_docs/version-2.0.0-beta.6/browser-support.md b/website/versioned_docs/version-2.0.0-beta.8/browser-support.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/browser-support.md
rename to website/versioned_docs/version-2.0.0-beta.8/browser-support.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/cli.md b/website/versioned_docs/version-2.0.0-beta.8/cli.md
similarity index 95%
rename from website/versioned_docs/version-2.0.0-beta.6/cli.md
rename to website/versioned_docs/version-2.0.0-beta.8/cli.md
index 026011d03a..9ea0d48af1 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/cli.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/cli.md
@@ -183,6 +183,12 @@ By default, the files are written in `website/i18n/<defaultLocale>/...`.
 | `--config` | `undefined` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 | `--messagePrefix` | `''` | Allows to add a prefix to each translation message, to help you highlight untranslated strings |
 
-### `docusaurus write-heading-ids [siteDir]` {#docusaurus-write-heading-ids-sitedir}
+### `docusaurus write-heading-ids [siteDir] [files]` {#docusaurus-write-heading-ids-sitedir}
 
 Add [explicit heading ids](./guides/markdown-features/markdown-features-headings.mdx#explicit-ids) to the Markdown documents of your site.
+
+| Name | Default | Description |
+| --- | --- | --- |
+| `files` | All MD files used by plugins | The files that you want heading IDs to be written to. |
+| `--maintain-case` | `false` | Keep the headings' casing, otherwise make all lowercase. |
+| `--overwrite` | `false` | Overwrite existing heading IDs. |
diff --git a/website/versioned_docs/version-2.0.0-beta.6/configuration.md b/website/versioned_docs/version-2.0.0-beta.8/configuration.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/configuration.md
rename to website/versioned_docs/version-2.0.0-beta.8/configuration.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/deployment.mdx b/website/versioned_docs/version-2.0.0-beta.8/deployment.mdx
similarity index 99%
rename from website/versioned_docs/version-2.0.0-beta.6/deployment.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/deployment.mdx
index 504d657ee5..d562499091 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/deployment.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/deployment.mdx
@@ -143,28 +143,22 @@ GitHub enterprise installations should work in the same manner as github.com; yo
 Finally, to deploy your site to GitHub Pages, run:
 
 ````mdx-code-block
-<Tabs
-  defaultValue="bash"
-  values={[
-    { label: 'Bash', value: 'bash' },
-    { label: 'Windows', value: 'windows' },
-    { label: 'PowerShell', value: 'powershell' }
-]}>
-<TabItem value="bash">
+<Tabs>
+<TabItem value="bash" label="Bash">
 
 ```bash
 GIT_USER=<GITHUB_USERNAME> yarn deploy
 ```
 
 </TabItem>
-<TabItem value="windows">
+<TabItem value="windows" label="Windows">
 
 ```batch
 cmd /C "set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy"
 ```
 
 </TabItem>
-<TabItem value="powershell">
+<TabItem value="powershell" label="PowerShell">
 
 ```powershell
 cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
diff --git a/website/versioned_docs/version-2.0.0-beta.6/docusaurus-core.md b/website/versioned_docs/version-2.0.0-beta.8/docusaurus-core.md
similarity index 98%
rename from website/versioned_docs/version-2.0.0-beta.6/docusaurus-core.md
rename to website/versioned_docs/version-2.0.0-beta.8/docusaurus-core.md
index d144820e93..eb456c6a07 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/docusaurus-core.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/docusaurus-core.md
@@ -253,6 +253,16 @@ export default function Home() {
 }
 ```
 
+:::note
+
+You can even omit a children prop and specify a translation string in your `code.json` file manually after running the `docusaurus write-translations` CLI command.
+
+```jsx
+<Translate id="homepage.title" />
+```
+
+:::
+
 ## Hooks {#hooks}
 
 ### `useDocusaurusContext` {#usedocusauruscontext}
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/creating-pages.md b/website/versioned_docs/version-2.0.0-beta.8/guides/creating-pages.md
similarity index 98%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/creating-pages.md
rename to website/versioned_docs/version-2.0.0-beta.8/guides/creating-pages.md
index c622ae5fcd..3330650847 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/creating-pages.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/creating-pages.md
@@ -45,7 +45,7 @@ function Hello() {
           fontSize: '20px',
         }}>
         <p>
-          Edit <code>pages/hello.js</code> and save to reload.
+          Edit <code>pages/helloReact.js</code> and save to reload.
         </p>
       </div>
     </Layout>
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-create-doc.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-create-doc.mdx
similarity index 75%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-create-doc.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-create-doc.mdx
index ab4d584d15..f068973ff7 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-create-doc.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-create-doc.mdx
@@ -35,7 +35,9 @@ will show up on the table of contents on the upper right
 
 So that your users will know what this page is all about without scrolling down or even without reading too much.
 
-### Only h2 and h3 will be in the toc
+### Only h2 and h3 will be in the toc by default.
+
+You can configure the TOC heading levels either per-document or in the theme configuration.
 
 The headers are well-spaced so that the hierarchy is clear.
 
@@ -67,7 +69,9 @@ will show up on the table of contents on the upper right
 
 So that your users will know what this page is all about without scrolling down or even without reading too much.
 
-<h3>Only h2 and h3 will be in the toc</h3>
+<h3>Only h2 and h3 will be in the toc by default.</h3>
+
+You can configure the TOC heading levels either per-document or in the theme configuration.
 
 The headers are well-spaced so that the hierarchy is clear.
 
@@ -84,11 +88,18 @@ With <code>{#custom-id}</code> syntax you can set your own header id.
 </BrowserWindow>
 ```
 
+:::note
+
+All files prefixed with an underscore (`_`) under the `docs` directory are treated as "partial" pages and will be ignored by default.
+
+Read more about [importing partial pages](../markdown-features/markdown-features-react.mdx#importing-markdown).
+
+:::
+
 ## Doc tags {#doc-tags}
 
 Optionally, you can add tags to your doc pages, which introduces another dimension of categorization in addition to the [docs sidebar](./sidebar.md). Tags are passed in the front matter as a list of labels:
 
-<!-- prettier-ignore-start -->
 ```yml "your-doc-page.md"
 ---
 id: doc-with-tags
@@ -98,4 +109,11 @@ tags:
   - Getting started
 ---
 ```
-<!-- prettier-ignore-end -->
+
+:::tip
+
+Tags can also be declared with `tags [Demo, Getting started]`
+
+Read more about all the possible [Yaml array syntaxes](https://www.w3schools.io/file/yaml-arrays/).
+
+:::
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-introduction.md b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-introduction.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-introduction.md
rename to website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-introduction.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-markdown-features.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-markdown-features.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-markdown-features.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-markdown-features.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-multi-instance.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/docs/docs-multi-instance.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/docs/docs-multi-instance.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/sidebar.md b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/sidebar.md
similarity index 98%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/docs/sidebar.md
rename to website/versioned_docs/version-2.0.0-beta.8/guides/docs/sidebar.md
index 47aecb43f2..dfc8c4175b 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/sidebar.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/sidebar.md
@@ -1,6 +1,7 @@
 ---
 id: sidebar
 title: Sidebar
+toc_max_heading_level: 4
 slug: /sidebar
 ---
 
@@ -173,6 +174,7 @@ type SidebarItemDoc =
       type: 'doc';
       id: string;
       label: string; // Sidebar label text
+      className?: string; // Class name for sidebar label
     }
 
   // Shorthand syntax
@@ -244,6 +246,7 @@ type SidebarItemLink = {
   type: 'link';
   label: string;
   href: string;
+  className?: string;
 };
 ```
 
@@ -282,6 +285,7 @@ type SidebarItemCategory = {
   type: 'category';
   label: string; // Sidebar label text.
   items: SidebarItem[]; // Array of sidebar items.
+  className?: string;
 
   // Category options:
   collapsible: boolean; // Set the category to be collapsible
@@ -519,7 +523,8 @@ This is the easy tutorial!
 ```json title="docs/tutorials/_category_.json"
 {
   "label": "Tutorial",
-  "position": 3
+  "position": 3,
+  "className": "red"
 }
 ```
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/docs/versioning.md b/website/versioned_docs/version-2.0.0-beta.8/guides/docs/versioning.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/docs/versioning.md
rename to website/versioned_docs/version-2.0.0-beta.8/guides/docs/versioning.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/_markdown-partial-example.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/_markdown-partial-example.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/_markdown-partial-example.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/_markdown-partial-example.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-admonitions.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-admonitions.mdx
similarity index 72%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-admonitions.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-admonitions.mdx
index ccd7ae68ff..69784e5dc1 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-admonitions.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-admonitions.mdx
@@ -89,23 +89,17 @@ Some **content** with _markdown_ `syntax`.
 
 You can use MDX inside admonitions too!
 
-```mdx
+```jsx
 import Tabs from '@theme/Tabs';
 
 import TabItem from '@theme/TabItem';
 
 :::tip Use tabs in admonitions
 
-<Tabs
-  defaultValue="apple"
-  values={[
-    {label: 'Apple', value: 'apple'},
-    {label: 'Orange', value: 'orange'},
-    {label: 'Banana', value: 'banana'},
-  ]}>
-  <TabItem value="apple">This is an apple 🍎</TabItem>
-  <TabItem value="orange">This is an orange 🍊</TabItem>
-  <TabItem value="banana">This is a banana 🍌</TabItem>
+<Tabs>
+  <TabItem value="apple" label="Apple">This is an apple 🍎</TabItem>
+  <TabItem value="orange" label="Orange">This is an orange 🍊</TabItem>
+  <TabItem value="banana" label="Banana">This is a banana 🍌</TabItem>
 </Tabs>
 
 :::
@@ -119,16 +113,10 @@ import TabItem from '@theme/TabItem';
 :::tip Use tabs in admonitions
 
 ```mdx-code-block
-<Tabs
-  defaultValue="apple"
-  values={[
-    {label: 'Apple', value: 'apple'},
-    {label: 'Orange', value: 'orange'},
-    {label: 'Banana', value: 'banana'},
-  ]}>
-  <TabItem value="apple">This is an apple 🍎</TabItem>
-  <TabItem value="orange">This is an orange 🍊</TabItem>
-  <TabItem value="banana">This is a banana 🍌</TabItem>
+<Tabs>
+  <TabItem value="apple" label="Apple">This is an apple 🍎</TabItem>
+  <TabItem value="orange" label="Orange">This is an orange 🍊</TabItem>
+  <TabItem value="banana" label="Banana">This is a banana 🍌</TabItem>
 </Tabs>
 ```
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-assets.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-assets.mdx
similarity index 97%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-assets.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-assets.mdx
index 8e0fa107f2..ae69e768ac 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-assets.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-assets.mdx
@@ -119,7 +119,7 @@ html[data-theme='dark'] .themedDocusaurus [fill='#FFFF50'] {
 
 ## Themed Images {#themed-images}
 
-Docusaurus supports themed images: the `ThemedImage` component (included in the classic/bootstrap themes) allows you to switch the image source based on the current theme.
+Docusaurus supports themed images: the `ThemedImage` component (included in the themes) allows you to switch the image source based on the current theme.
 
 ```jsx {5-8}
 import ThemedImage from '@theme/ThemedImage';
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-code-blocks.mdx
similarity index 86%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-code-blocks.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-code-blocks.mdx
index 7fedb93fec..5c355f1e46 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -374,15 +374,8 @@ The following example is how you can have multi-language code tabs in your docs.
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-<Tabs
-  defaultValue="js"
-  values={[
-    { label: 'JavaScript', value: 'js', },
-    { label: 'Python', value: 'py', },
-    { label: 'Java', value: 'java', },
-  ]
-}>
-<TabItem value="js">
+<Tabs>
+<TabItem value="js" label="JavaScript">
 
 ```js
 function helloWorld() {
@@ -391,7 +384,7 @@ function helloWorld() {
 ```
 
 </TabItem>
-<TabItem value="py">
+<TabItem value="py" label="Python">
 
 ```py
 def hello_world():
@@ -399,7 +392,7 @@ def hello_world():
 ```
 
 </TabItem>
-<TabItem value="java">
+<TabItem value="java" label="Java">
 
 ```java
 class HelloWorld {
@@ -416,15 +409,8 @@ class HelloWorld {
 And you will get the following:
 
 ````mdx-code-block
-<Tabs
-  defaultValue="js"
-  values={[
-    { label: 'JavaScript', value: 'js', },
-    { label: 'Python', value: 'py', },
-    { label: 'Java', value: 'java', },
-  ]
-}>
-<TabItem value="js">
+<Tabs>
+<TabItem value="js" label="JavaScript">
 
 ```js
 function helloWorld() {
@@ -433,7 +419,7 @@ function helloWorld() {
 ```
 
 </TabItem>
-<TabItem value="py">
+<TabItem value="py" label="Python">
 
 ```py
 def hello_world():
@@ -441,7 +427,7 @@ def hello_world():
 ```
 
 </TabItem>
-<TabItem value="java">
+<TabItem value="java" label="Java">
 
 ```java
 class HelloWorld {
@@ -455,6 +441,51 @@ class HelloWorld {
 </Tabs>
 ````
 
-You may want to implement your own `<MultiLanguageCode />` abstraction if you find the above approach too verbose. We might just implement one in future for convenience.
-
 If you have multiple of these multi-language code tabs, and you want to sync the selection across the tab instances, refer to the [Syncing tab choices section](markdown-features-tabs.mdx#syncing-tab-choices).
+
+### Docusaurus npm2yarn remark plugin {#npm2yarn-remark-plugin}
+
+Displaying CLI commands in both NPM and Yarn is a very common need, for example:
+
+```bash npm2yarn
+npm install @docusaurus/remark-plugin-npm2yarn
+```
+
+Docusaurus provides such a utility out of the box, freeing you from using the `Tabs` component every time. To enable this feature, first install the `@docusaurus/remark-plugin-npm2yarn` package as above, and then in `docusaurus.config.js`, for the plugins where you need this feature (doc, blog, pages, etc.), register it in the `remarkPlugins` option. (See [Docs configuration](../../api/plugins/plugin-content-docs.md#ex-config) for more details on configuration format)
+
+```js title="docusaurus.config.js"
+module.exports = {
+  // ...
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        docs: {
+          // highlight-start
+          remarkPlugins: [
+            [require('@docusaurus/remark-plugin-npm2yarn'), {sync: true}],
+          ],
+          // highlight-end
+        },
+        pages: {
+          // highlight-next-line
+          remarkPlugins: [require('@docusaurus/remark-plugin-npm2yarn')],
+        },
+        blog: {
+          // ...
+        },
+      },
+    ],
+  ],
+};
+```
+
+And then use it by adding the `npm2yarn` key to the code block:
+
+````md
+```bash npm2yarn
+npm install @docusaurus/remark-plugin-npm2yarn
+```
+````
+
+Using the `{sync: true}` option would make all tab choices synced. Because the choice is stored under the same namespace `npm2yarn`, different `npm2yarn` plugin instances would also sync their choices.
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-head-metadatas.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-head-metadatas.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-head-metadatas.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-head-metadatas.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-headings.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-headings.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-headings.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-headings.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-inline-toc.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-inline-toc.mdx
similarity index 90%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-inline-toc.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-inline-toc.mdx
index 5f839da3b8..3726f04842 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-inline-toc.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-inline-toc.mdx
@@ -13,7 +13,9 @@ But it is also possible to display an inline table of contents directly inside a
 
 ## Full table of contents {#full-table-of-contents}
 
-The `toc` variable is available in any MDX document, and contain all the top level headings of a MDX document.
+The `toc` variable is available in any MDX document, and contains all the headings of a MDX document.
+
+By default, only `h2` and `h3` headings are displayed in the TOC. You can change which heading levels are visible by setting `minHeadingLevel` or `maxHeadingLevel`.
 
 ```jsx
 import TOCInline from '@theme/TOCInline';
@@ -40,6 +42,7 @@ type TOCItem = {
   value: string;
   id: string;
   children: TOCItem[];
+  level: number;
 };
 ```
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-intro.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-intro.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-intro.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-math-equations.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-math-equations.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-math-equations.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-plugins.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-plugins.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-plugins.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-react.mdx
similarity index 94%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-react.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-react.mdx
index 4f920c5d20..08aed08e3a 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-react.mdx
@@ -11,7 +11,7 @@ import BrowserWindow from '@site/src/components/BrowserWindow';
 
 ## Using JSX in Markdown {#using-jsx-in-markdown}
 
-Docusaurus has built-in support for [MDX](https://mdxjs.com/), which allows you to write JSX within your Markdown files and render them as React components.
+Docusaurus has built-in support for [MDX v1](https://mdxjs.com/), which allows you to write JSX within your Markdown files and render them as React components.
 
 :::note
 
@@ -23,7 +23,7 @@ While both `.md` and `.mdx` files are parsed using MDX, some of the syntax are t
 
 MDX is not [100% compatible with CommonMark](https://github.com/facebook/docusaurus/issues/3018).
 
-Use the **[MDX playground](https://mdxjs.com/playground)** to ensure that your syntax is valid MDX.
+Use the **[MDX playground](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/playground)** to ensure that your syntax is valid MDX.
 
 :::
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-tabs.mdx b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-tabs.mdx
similarity index 78%
rename from website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-tabs.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-tabs.mdx
index 4e4e2da682..5fc9d5acd1 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/guides/markdown-features/markdown-features-tabs.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/guides/markdown-features/markdown-features-tabs.mdx
@@ -13,6 +13,7 @@ import TabItem from '@theme/TabItem';
 
 Docusaurus provides `<Tabs>` components that you can use thanks to [MDX](./markdown-features-react.mdx):
 
+<!-- prettier-ignore-start -->
 ```jsx
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
@@ -27,13 +28,14 @@ import TabItem from '@theme/TabItem';
   <TabItem value="banana" label="Banana">
     This is a banana 🍌
   </TabItem>
-</Tabs>;
+</Tabs>
 ```
+<!-- prettier-ignore-end -->
 
 ```mdx-code-block
 <BrowserWindow>
   <Tabs>
-    <TabItem value="apple" label="Apple" default>This is an apple 🍎</TabItem>
+    <TabItem value="apple" label="Apple">This is an apple 🍎</TabItem>
     <TabItem value="orange" label="Orange">This is an orange 🍊</TabItem>
     <TabItem value="banana" label="Banana">This is a banana 🍌</TabItem>
   </Tabs>
@@ -109,7 +111,7 @@ It is also possible to provide `values` and `defaultValue` props to `Tabs`:
     ]}>
     <TabItem value="apple" label="Apple 2">This is an apple 🍎</TabItem>
     <TabItem value="orange" label="Orange 2">This is an orange 🍊</TabItem>
-    <TabItem value="banana" label="Banana 2">This is a banana 🍌</TabItem>
+    <TabItem value="banana" label="Banana 2" default>This is a banana 🍌</TabItem>
   </Tabs>
 </BrowserWindow>
 <br/>
@@ -121,17 +123,15 @@ It is also possible to provide `values` and `defaultValue` props to `Tabs`:
 
 By default, all tabs are rendered eagerly during the build process, and search engines can index hidden tabs.
 
-It is possible to only render the default tab with `<Tabs lazy={true} />`.
+It is possible to only render the default tab with `<Tabs lazy />`.
 
 :::
 
 ## Displaying a default tab
 
-Add `default` to one of the tab items to make it displayed by default. You can also set the `defaultValue` prop in the `Tabs` component to the label value of your choice.
+The first tab is displayed by default, and to override this behavior, you can specify a default tab by adding `default` to one of the tab items. You can also set the `defaultValue` prop of the `Tabs` component to the label value of your choice. For example, in the example above, either setting `default` for the `value="apple"` tab or setting `defaultValue="apple"` for the tabs forces the "Apple" tab to be open by default.
 
-For example, in the example above, setting `default` for the `value="apple"` tab forces it to be open by default.
-
-If none of the children contains the `default` prop, neither is the `defaultValue` provided for the `Tabs`, or it refers to an non-existing value, only the tab headings appear until the user clicks on a tab.
+Docusaurus will throw an error if a `defaultValue` is provided for the `Tabs` but it refers to an non-existing value. If you want none of the tabs to be shown by default, use `defaultValue={null}`.
 
 ## Syncing tab choices {#syncing-tab-choices}
 
@@ -140,13 +140,13 @@ You may want choices of the same kind of tabs to sync with each other. For examp
 ```jsx
 // highlight-next-line
 <Tabs groupId="operating-systems">
-  <TabItem value="win" label="Windows" default>Use Ctrl + C to copy.</TabItem>
+  <TabItem value="win" label="Windows">Use Ctrl + C to copy.</TabItem>
   <TabItem value="mac" label="MacOS">Use Command + C to copy.</TabItem>
 </Tabs>
 
 // highlight-next-line
 <Tabs groupId="operating-systems">
-  <TabItem value="win" label="Windows" default>Use Ctrl + V to paste.</TabItem>
+  <TabItem value="win" label="Windows">Use Ctrl + V to paste.</TabItem>
   <TabItem value="mac" label="MacOS">Use Command + V to paste.</TabItem>
 </Tabs>
 ```
@@ -154,12 +154,12 @@ You may want choices of the same kind of tabs to sync with each other. For examp
 ```mdx-code-block
 <BrowserWindow>
   <Tabs groupId="operating-systems">
-    <TabItem value="win" label="Windows" default>Use Ctrl + C to copy.</TabItem>
+    <TabItem value="win" label="Windows">Use Ctrl + C to copy.</TabItem>
     <TabItem value="mac" label="MacOS">Use Command + C to copy.</TabItem>
   </Tabs>
 
   <Tabs groupId="operating-systems">
-    <TabItem value="win" label="Windows" default>Use Ctrl + V to paste.</TabItem>
+    <TabItem value="win" label="Windows">Use Ctrl + V to paste.</TabItem>
     <TabItem value="mac" label="MacOS">Use Command + V to paste.</TabItem>
   </Tabs>
 </BrowserWindow>
@@ -170,7 +170,7 @@ For all tab groups that have the same `groupId`, the possible values do not need
 
 ```jsx
 <Tabs groupId="operating-systems">
-  <TabItem value="win" label="Windows" default>
+  <TabItem value="win" label="Windows">
     I am Windows.
   </TabItem>
   <TabItem value="mac" label="MacOS">
@@ -185,7 +185,7 @@ For all tab groups that have the same `groupId`, the possible values do not need
 ```mdx-code-block
 <BrowserWindow>
   <Tabs groupId="operating-systems">
-    <TabItem value="win" label="Windows" default>I am Windows.</TabItem>
+    <TabItem value="win" label="Windows">I am Windows.</TabItem>
     <TabItem value="mac" label="MacOS">I am macOS.</TabItem>
     <TabItem value="linux" label="Linux">I am Linux.</TabItem>
   </Tabs>
@@ -199,13 +199,13 @@ Tab choices with different `groupId`s will not interfere with each other:
 ```jsx
 // highlight-next-line
 <Tabs groupId="operating-systems">
-  <TabItem value="win" label="Windows" default>Windows in windows.</TabItem>
+  <TabItem value="win" label="Windows">Windows in windows.</TabItem>
   <TabItem value="mac" label="MacOS">macOS is macOS.</TabItem>
 </Tabs>
 
 // highlight-next-line
 <Tabs groupId="non-mac-operating-systems">
-  <TabItem value="win" label="Windows" default>Windows is windows.</TabItem>
+  <TabItem value="win" label="Windows">Windows is windows.</TabItem>
   <TabItem value="unix" label="Unix">Unix is unix.</TabItem>
 </Tabs>
 ```
@@ -213,12 +213,12 @@ Tab choices with different `groupId`s will not interfere with each other:
 ```mdx-code-block
 <BrowserWindow>
   <Tabs groupId="operating-systems">
-    <TabItem value="win" label="Windows" default>Windows in windows.</TabItem>
+    <TabItem value="win" label="Windows">Windows in windows.</TabItem>
     <TabItem value="mac" label="MacOS">macOS is macOS.</TabItem>
   </Tabs>
 
   <Tabs groupId="non-mac-operating-systems">
-    <TabItem value="win" label="Windows" default>Windows is windows.</TabItem>
+    <TabItem value="win" label="Windows">Windows is windows.</TabItem>
     <TabItem value="unix" label="Unix">Unix is unix.</TabItem>
   </Tabs>
 </BrowserWindow>
@@ -234,9 +234,7 @@ import TabItem from '@theme/TabItem';
 
 // highlight-next-line
 <Tabs className="unique-tabs">
-  <TabItem value="Apple" default>
-    This is an apple 🍎
-  </TabItem>
+  <TabItem value="Apple">This is an apple 🍎</TabItem>
   <TabItem value="Orange">This is an orange 🍊</TabItem>
   <TabItem value="Banana">This is a banana 🍌</TabItem>
 </Tabs>;
@@ -245,7 +243,7 @@ import TabItem from '@theme/TabItem';
 ```mdx-code-block
 <BrowserWindow>
   <Tabs className="unique-tabs">
-    <TabItem value="Apple" default>This is an apple 🍎</TabItem>
+    <TabItem value="Apple">This is an apple 🍎</TabItem>
     <TabItem value="Orange">This is an orange 🍊</TabItem>
     <TabItem value="Banana">This is a banana 🍌</TabItem>
   </Tabs>
diff --git a/website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-crowdin.mdx
similarity index 98%
rename from website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-crowdin.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-crowdin.mdx
index ef038d068c..953372107d 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-crowdin.mdx
@@ -2,6 +2,7 @@
 id: crowdin
 title: i18n - Using Crowdin
 slug: /i18n/crowdin
+toc_max_heading_level: 4
 ---
 
 The i18n system of Docusaurus is **decoupled from any translation software**.
@@ -363,20 +364,15 @@ import Tabs from '@theme/Tabs';
 
 import TabItem from '@theme/TabItem';
 
-<Tabs
-  defaultValue="bash"
-  values={[
-    { label: 'Bash', value: 'bash' },
-    { label: 'Windows', value: 'windows' }
-]}>
-  <TabItem value="bash">
+<Tabs>
+  <TabItem value="bash" label="Bash">
 
   ```bash
   GIT_USER=<GITHUB_USERNAME> yarn deploy
   ```
 
   </TabItem>
-  <TabItem value="windows">
+  <TabItem value="windows" label="Windows">
 
   ```batch
   cmd /C "set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy"
diff --git a/website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-git.md b/website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-git.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-git.md
rename to website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-git.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-introduction.md b/website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-introduction.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-introduction.md
rename to website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-introduction.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-tutorial.md b/website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-tutorial.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/i18n/i18n-tutorial.md
rename to website/versioned_docs/version-2.0.0-beta.8/i18n/i18n-tutorial.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/installation.md b/website/versioned_docs/version-2.0.0-beta.8/installation.md
similarity index 89%
rename from website/versioned_docs/version-2.0.0-beta.6/installation.md
rename to website/versioned_docs/version-2.0.0-beta.8/installation.md
index 9deaa6dabb..92e6368bb2 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/installation.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/installation.md
@@ -29,10 +29,10 @@ npm init docusaurus@latest [name] [template]
 Example:
 
 ```bash
-npm init docusaurus@latest my-website classic
+npm init docusaurus@latest website classic
 ```
 
-If you do not specify `name` or `template`, it will prompt you for them. We recommend the `classic` template so that you can get started quickly and it contains features found in Docusaurus 1. The `classic` template contains `@docusaurus/preset-classic` which includes standard documentation, a blog, custom pages, and a CSS framework (with dark mode support). You can get up and running extremely quickly with the classic template and customize things later on when you have gained more familiarity with Docusaurus.
+If you do not specify `name` or `template`, it will prompt you for them. We recommend the `classic` template so that you can get started quickly, and it contains features found in Docusaurus 1. The `classic` template contains `@docusaurus/preset-classic` which includes standard documentation, a blog, custom pages, and a CSS framework (with dark mode support). You can get up and running extremely quickly with the classic template and customize things later on when you have gained more familiarity with Docusaurus.
 
 **[FB-Only]:** If you are setting up a new Docusaurus website for a Facebook open source project, use the `facebook` template instead, which comes with some useful Facebook-specific defaults:
 
@@ -40,22 +40,16 @@ If you do not specify `name` or `template`, it will prompt you for them. We reco
 npm init docusaurus@latest my-website facebook
 ```
 
-**[Experimental]:** If you want setting up a new website using [bootstrap](https://getbootstrap.com/), use the `bootstrap` template, like the following:
-
-```bash
-npm init docusaurus@latest my-website bootstrap
-```
-
 If you want to skip installing dependencies, use the `--skip-install` option, like the following:
 
 ```bash
-npm init docusaurus@latest my-website classic --skip-install
+npm init docusaurus@latest my-website classic -- --skip-install
 ```
 
 You can also use the template's TypeScript variant by passing the `--typescript` flag.
 
 ```bash
-npm init docusaurus@latest my-website classic --typescript
+npm init docusaurus@latest my-website classic -- --typescript
 ```
 
 ## Project structure {#project-structure}
diff --git a/website/versioned_docs/version-2.0.0-beta.6/introduction.md b/website/versioned_docs/version-2.0.0-beta.8/introduction.md
similarity index 99%
rename from website/versioned_docs/version-2.0.0-beta.6/introduction.md
rename to website/versioned_docs/version-2.0.0-beta.8/introduction.md
index 97601dff31..cf2783fee4 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/introduction.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/introduction.md
@@ -177,7 +177,7 @@ In comparison with statically generated HTML and interactivity added using `<scr
 - [GitHub](https://github.com/facebook/docusaurus)
 - [Twitter](https://twitter.com/docusaurus)
 - [Blog](/blog)
-- [Discord](https://discord.gg/Je6Ash6)
+- [Discord](https://discord.gg/docusaurus)
 
 ## Something missing? {#something-missing}
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/lifecycle-apis.md b/website/versioned_docs/version-2.0.0-beta.8/lifecycle-apis.md
similarity index 99%
rename from website/versioned_docs/version-2.0.0-beta.6/lifecycle-apis.md
rename to website/versioned_docs/version-2.0.0-beta.8/lifecycle-apis.md
index a0cbc889eb..8dd9d25772 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/lifecycle-apis.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/lifecycle-apis.md
@@ -1,6 +1,7 @@
 ---
 id: lifecycle-apis
 title: Lifecycle APIs
+toc_max_heading_level: 4
 ---
 
 :::caution
@@ -162,9 +163,9 @@ Plugins should use the data loaded in `loadContent` and construct the pages/rout
 
 ### `actions` {#actions}
 
-`actions` contain two functions:
+`actions` contain three functions:
 
-- `addRoute(config: RouteConfig): void`
+#### `addRoute(config: RouteConfig): void`
 
 Create a route to add to the website.
 
@@ -189,7 +190,7 @@ type Module =
   | string;
 ```
 
-- `createData(name: string, data: any): Promise<string>`
+#### `createData(name: string, data: any): Promise<string>`
 
 A function to help you create static data (generally json or string), that you can provide to your routes as props.
 
@@ -231,7 +232,7 @@ export default function friendsPlugin(context, options) {
 }
 ```
 
-- `setGlobalData(data: any): void`
+#### `setGlobalData(data: any): void`
 
 This function permits to create some global plugin data, that can be read from any page, including the pages created by other plugins, and your theme layout.
 
@@ -396,7 +397,7 @@ module.exports = function (context, options) {
 Called when a (production) build finishes.
 
 ```ts
-type Props = {
+interface Props {
   siteDir: string;
   generatedFilesDir: string;
   siteConfig: DocusaurusConfig;
@@ -407,7 +408,7 @@ type Props = {
   postBodyTags: string;
   routesPaths: string[];
   plugins: Plugin<any>[];
-};
+}
 ```
 
 Example:
diff --git a/website/versioned_docs/version-2.0.0-beta.6/migration/migration-automated.md b/website/versioned_docs/version-2.0.0-beta.8/migration/migration-automated.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/migration/migration-automated.md
rename to website/versioned_docs/version-2.0.0-beta.8/migration/migration-automated.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/migration/migration-manual.md b/website/versioned_docs/version-2.0.0-beta.8/migration/migration-manual.md
similarity index 99%
rename from website/versioned_docs/version-2.0.0-beta.6/migration/migration-manual.md
rename to website/versioned_docs/version-2.0.0-beta.8/migration/migration-manual.md
index a20d3622fb..460e07d5a7 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/migration/migration-manual.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/migration/migration-manual.md
@@ -2,6 +2,7 @@
 id: migration-manual
 title: Manual migration
 slug: /migration/manual
+toc_max_heading_level: 4
 ---
 
 This manual migration process should be run after the [automated migration process](./migration-automated.md), to complete the missing parts, or debug issues in the migration CLI output.
diff --git a/website/versioned_docs/version-2.0.0-beta.6/migration/migration-overview.md b/website/versioned_docs/version-2.0.0-beta.8/migration/migration-overview.md
similarity index 96%
rename from website/versioned_docs/version-2.0.0-beta.6/migration/migration-overview.md
rename to website/versioned_docs/version-2.0.0-beta.8/migration/migration-overview.md
index 9b2310e41a..8ddda200b0 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/migration/migration-overview.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/migration/migration-overview.md
@@ -94,7 +94,7 @@ The [manual migration guide](./migration-manual.md) will give you all the manual
 
 ## Support {#support}
 
-For any questions, you can ask in the [`#docusaurus-1-to-2-migration` Discord channel](https://discordapp.com/invite/kYaNd6V).
+For any questions, you can ask in the [`#migration-v1-to-v2` Discord channel](https://discord.gg/C3P6CxMMxY).
 
 Feel free to tag [@slorber](https://github.com/slorber) in any migration PRs if you would like us to have a look.
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/migration/migration-translated-sites.md b/website/versioned_docs/version-2.0.0-beta.8/migration/migration-translated-sites.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/migration/migration-translated-sites.md
rename to website/versioned_docs/version-2.0.0-beta.8/migration/migration-translated-sites.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/migration/migration-versioned-sites.md b/website/versioned_docs/version-2.0.0-beta.8/migration/migration-versioned-sites.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/migration/migration-versioned-sites.md
rename to website/versioned_docs/version-2.0.0-beta.8/migration/migration-versioned-sites.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/playground.mdx b/website/versioned_docs/version-2.0.0-beta.8/playground.mdx
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/playground.mdx
rename to website/versioned_docs/version-2.0.0-beta.8/playground.mdx
diff --git a/website/versioned_docs/version-2.0.0-beta.6/presets.md b/website/versioned_docs/version-2.0.0-beta.8/presets.md
similarity index 66%
rename from website/versioned_docs/version-2.0.0-beta.6/presets.md
rename to website/versioned_docs/version-2.0.0-beta.8/presets.md
index b24a6e9380..7d3eddb070 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/presets.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/presets.md
@@ -35,16 +35,13 @@ module.exports = {
 
 ## Presets -> themes and plugins {#presets---themes-and-plugins}
 
-Presets in some way are a shorthand function to add plugins and themes to your Docusaurus config. For example, you can specify a preset that includes the following themes and plugins,
+Presets are a shorthand function to add plugins and themes to your Docusaurus config. For example, you can specify a preset that includes the following themes and plugins,
 
 ```js
 module.exports = function preset(context, opts = {}) {
   return {
-    themes: [
-      require.resolve('@docusaurus/themes-cool'),
-      require.resolve('@docusaurus/themes-bootstrap'),
-    ],
-    plugins: [require.resolve('@docusaurus/plugin-blog')],
+    themes: ['@docusaurus/theme-cool', opts.cool],
+    plugins: ['@docusaurus/plugin-blog', opts.blog],
   };
 };
 ```
@@ -53,8 +50,10 @@ then in your Docusaurus config, you may configure the preset instead:
 
 ```jsx {3} title="docusaurus.config.js"
 module.exports = {
-  // ...
-  presets: ['@docusaurus/preset-my-own'],
+  presets: [
+    '@docusaurus/preset-my-own',
+    {cool: {hello: 'world'}, blog: {path: '/blog'}},
+  ],
 };
 ```
 
@@ -62,8 +61,8 @@ This is equivalent of doing:
 
 ```jsx title="docusaurus.config.js"
 module.exports = {
-  themes: ['@docusaurus/themes-cool', '@docusaurus/themes-bootstrap'],
-  plugins: ['@docusaurus/plugin-blog'],
+  themes: ['@docusaurus/themes-cool', {hello: 'world'}],
+  plugins: ['@docusaurus/plugin-blog', {path: '/blog'}],
 };
 ```
 
@@ -132,51 +131,3 @@ module.exports = {
   ],
 };
 ```
-
-### `@docusaurus/preset-bootstrap` {#docusauruspreset-bootstrap}
-
-An alternative preset that uses Bootstrap styling.
-
-| Themes                        | Plugins                            |
-| ----------------------------- | ---------------------------------- |
-| `@docusaurus/theme-bootstrap` | `@docusaurus/plugin-content-docs`  |
-|                               | `@docusaurus/plugin-content-blog`  |
-|                               | `@docusaurus/plugin-content-pages` |
-|                               | `@docusaurus/plugin-debug`         |
-
-To specify plugin options individually, you can provide the necessary fields to certain plugins, i.e. `docs` for `@docusaurus/theme-bootstrap`, pass them in the preset field, like this:
-
-```js title="docusaurus.config.js"
-module.exports = {
-  presets: [
-    [
-      '@docusaurus/preset-bootstrap',
-      {
-        // Debug defaults to true in dev, false in prod
-        debug: undefined,
-        // Will be passed to @docusaurus/plugin-content-docs (false to disable)
-        docs: {},
-        // Will be passed to @docusaurus/plugin-content-blog (false to disable)
-        blog: {},
-      },
-    ],
-  ],
-};
-```
-
-:::caution
-
-This preset is work in progress
-
-:::
-
-<!--
-
-Advanced guide on using and configuring presets
-
-References
----
-- [classic themes](/packages/docusaurus-preset-classic/src/index.js)
-- [babel docs on presets](https://babeljs.io/docs/en/presets)
-
--->
diff --git a/website/versioned_docs/version-2.0.0-beta.6/search.md b/website/versioned_docs/version-2.0.0-beta.8/search.md
similarity index 55%
rename from website/versioned_docs/version-2.0.0-beta.6/search.md
rename to website/versioned_docs/version-2.0.0-beta.8/search.md
index b22ef0ed47..ceb6541a59 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/search.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/search.md
@@ -6,18 +6,60 @@ keywords:
   - search
 ---
 
-Docusaurus' own `@docusaurus/preset-classic` supports a search integration.
+There are a few options you can use to add search to your website:
 
-There are two main options, you can use [Algolia DocSearch](https://docsearch.algolia.com) or bring in your own `SearchBar` component.
+- 🥇 [Algolia DocSearch](#using-algolia-docsearch) (**official**)
+- 👥 [Typesense DocSearch](#using-typesense-docsearch)
+- 👥 [Local Search](#using-local-search)
+- 👥 [Your own `SearchBar` component](#using-your-own-search)
 
-## Using Algolia DocSearch {#using-algolia-docsearch}
+:::info
 
-Algolia DocSearch works by crawling the content of your website every 24 hours and putting all the content in an Algolia index. This content is then queried directly from your front-end using the Algolia API. Note that your website needs to be publicly available for this to work (i.e., not behind a firewall). The service is free.
+🥇 Docusaurus provides **first-class support** for [Algolia DocSearch](#using-algolia-docsearch).
 
-If your website is [not eligible](https://docsearch.algolia.com/docs/who-can-apply) for the free, hosted version of DocSearch, or if your website sits behind a firewall, then you can [run your own](https://docsearch.algolia.com/docs/run-your-own/) DocSearch crawler. For best results, you may want to use a config file based on the [Docusaurus 2 config](https://github.com/algolia/docsearch-configs/blob/master/configs/docusaurus-2.json).
+👥 Other options are **maintained by the community**: please report bugs to their respective repositories.
+
+:::
+
+## 🥇 Using Algolia DocSearch {#using-algolia-docsearch}
+
+Docusaurus has **official support** for [Algolia DocSearch](https://docsearch.algolia.com).
+
+The service is **free** in most cases: just [apply to the DocSearch program](https://docsearch.algolia.com/docs/apply).
+
+It works by crawling the content of your website every 24 hours and putting all the content in an Algolia index. This content is then queried directly from your front-end using the Algolia API.
+
+If your website is [not eligible](https://docsearch.algolia.com/docs/who-can-apply) for the free, hosted version of DocSearch, or if your website sits behind a firewall and is not public, then you can [run your own](https://docsearch.algolia.com/docs/run-your-own/) DocSearch crawler.
+
+:::note
+
+By default, the Docusaurus preset generates a [sitemap.xml](https://docusaurus.io/sitemap.xml) that the Algolia crawler can use.
+
+:::
+
+### Index Configuration {#algolia-index-configuration}
+
+After applying, your site's DocSearch config should be created at:
+
+```
+https://github.com/algolia/docsearch-configs/blob/master/configs/<indexName>.json
+```
+
+This configuration file can be updated by:
+
+- [**asking for help**](#algolia-support): the DocSearch team can help you maintain it
+- opening a pull-requests in [algolia/docsearch-configs](https://github.com/algolia/docsearch-configs)
+
+:::caution
+
+It is highly recommended using a config similar to the [**Docusaurus 2 website config**](https://github.com/algolia/docsearch-configs/blob/master/configs/docusaurus-2.json).
+
+:::
 
 ### Connecting Algolia {#connecting-algolia}
 
+Docusaurus' own `@docusaurus/preset-classic` supports an Algolia DocSearch integration.
+
 To connect your docs with Algolia, first add the package to your website:
 
 ```bash npm2yarn
@@ -33,7 +75,12 @@ module.exports = {
     // ...
     // highlight-start
     algolia: {
-      apiKey: 'YOUR_API_KEY',
+      // If Algolia did not provide you any appId, use 'BH4D9OD16A'
+      appId: 'YOUR_APP_ID',
+
+      // Public API key: it is safe to commit it
+      apiKey: 'YOUR_SEARCH_API_KEY',
+
       indexName: 'YOUR_INDEX_NAME',
 
       // Optional: see doc section below
@@ -58,6 +105,14 @@ The `searchParameters` option used to be named `algoliaOptions` in Docusaurus v1
 
 :::
 
+:::caution
+
+The search feature will not work reliably until Algolia crawls your site with the **search plugin enabled**.
+
+If you are installing the Algolia plugin for the first time and want to ensure the search feature works before deploying it to production, you can ask the DocSearch team to trigger a crawl on a staging environment url or deploy preview.
+
+:::
+
 ### Contextual search {#contextual-search}
 
 Contextual search is mostly useful for versioned Docusaurus sites.
@@ -89,24 +144,6 @@ When using `contextualSearch: true`, the contextual facet filters will be merged
 
 :::
 
-### Custom Application ID {#custom-application-id}
-
-When [running your own](https://docsearch.algolia.com/docs/run-your-own/) DocSearch crawler, it is [required to set the `appId` configuration key](https://docsearch.algolia.com/docs/behavior/#appid) to your own Application ID. If left unset, the `appId` will fallback to the one used with the free, hosted version of Algolia DocSearch.
-
-```jsx title="docusaurus.config.js"
-module.exports = {
-  // ...
-  themeConfig: {
-    // ...
-    // highlight-start
-    algolia: {
-      appId: 'YOUR_APP_ID',
-    },
-    // highlight-end
-  },
-};
-```
-
 ### Styling your Algolia search {#styling-your-algolia-search}
 
 By default, DocSearch comes with a fine-tuned theme that was designed for accessibility, making sure that colors and contrasts respect standards.
@@ -182,7 +219,37 @@ If you prefer to edit the Algolia search React component, swizzle the `SearchBar
 npm run swizzle @docusaurus/theme-search-algolia SearchBar
 ```
 
-## Using your own search {#using-your-own-search}
+### Support {#algolia-support}
+
+The Algolia DocSearch team can help you figure out search problems on your site.
+
+You can contact them by [email](mailto:documentationsearch@algolia.com) or on [Discord](https://discord.gg/tXdr5mP).
+
+Docusaurus also has an `#algolia` channel on [Discord](https://discordapp.com/invite/docusaurus).
+
+## 👥 Using Typesense DocSearch {#using-typesense-docsearch}
+
+[Typesense](https://typesense.org) DocSearch works similar to Algolia DocSearch, except that your website is indexed into a Typesense search cluster.
+
+Typesense is an [open source](https://github.com/typesense/typesense) instant-search engine that you can either:
+
+- [Self-Host](https://typesense.org/docs/latest/guide/install-typesense.html#option-2-local-machine-self-hosting) on your own servers or
+- Use the Managed [Typesense Cloud](https://cloud.typesense.org) service.
+
+Similar to Algolia DocSearch, there are two components:
+
+- [typesense-docsearch-scraper](https://github.com/typesense/typesense-docsearch-scraper) - which scrapes your website and indexes the data in your Typesense cluster.
+- [docusaurus-theme-search-typesense](https://github.com/typesense/docusaurus-theme-search-typesense) - a search bar UI component to add to your website.
+
+Read a step-by-step walk-through of how to [run typesense-docsearch-scraper here](https://typesense.org/docs/latest/guide/docsearch.html#step-1-set-up-docsearch-scraper) and how to [install the Search Bar in your Docusaurus Site here](https://typesense.org/docs/latest/guide/docsearch.html#option-a-docusaurus-powered-sites).
+
+## 👥 Using Local Search {#using-local-search}
+
+You can use a local search plugin for websites where the search index is small and can be downloaded to your users' browsers when they visit your website.
+
+You'll find a list of community-supported [local search plugins listed here](https://docusaurus.io/community/resources#search).
+
+## 👥 Using your own search {#using-your-own-search}
 
 To use your own search, swizzle the `SearchBar` component in `@docusaurus/theme-classic`
 
diff --git a/website/versioned_docs/version-2.0.0-beta.6/static-assets.md b/website/versioned_docs/version-2.0.0-beta.8/static-assets.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/static-assets.md
rename to website/versioned_docs/version-2.0.0-beta.8/static-assets.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/styling-layout.md b/website/versioned_docs/version-2.0.0-beta.8/styling-layout.md
similarity index 100%
rename from website/versioned_docs/version-2.0.0-beta.6/styling-layout.md
rename to website/versioned_docs/version-2.0.0-beta.8/styling-layout.md
diff --git a/website/versioned_docs/version-2.0.0-beta.6/typescript-support.md b/website/versioned_docs/version-2.0.0-beta.8/typescript-support.md
similarity index 85%
rename from website/versioned_docs/version-2.0.0-beta.6/typescript-support.md
rename to website/versioned_docs/version-2.0.0-beta.8/typescript-support.md
index 8b1cff8fef..dd235ddd5b 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/typescript-support.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/typescript-support.md
@@ -3,24 +3,24 @@ id: typescript-support
 title: TypeScript Support
 ---
 
-Docusaurus is written in TypeScript, and provide first-class TypeScript support.
+Docusaurus is written in TypeScript, and provides first-class TypeScript support.
 
 ## Initialization {#initialization}
 
 Docusaurus supports writing and using TypeScript theme components. If the init template provides a Typescript variant, you can directly initialize a site with full TypeScript support by using the `--typescript` flag.
 
 ```bash
-npm init docusaurus@latest my-website classic --typescript
+npm init docusaurus@latest my-website classic -- --typescript
 ```
 
 Below are some guides on how to migrate an existing project to TypeScript.
 
 ## Setup {#setup}
 
-To start using TypeScript, add `@docusaurus/module-type-aliases` and some `@types` dependencies to your project:
+To start using TypeScript, add `@docusaurus/module-type-aliases` and the base TS config to your project:
 
 ```bash npm2yarn
-npm install --save-dev typescript @docusaurus/module-type-aliases @types/react @types/react-router-dom @types/react-helmet @tsconfig/docusaurus
+npm install --save-dev typescript @docusaurus/module-type-aliases @tsconfig/docusaurus
 ```
 
 Then add `tsconfig.json` to your project root with the following content:
@@ -42,8 +42,11 @@ It is **not possible** to use a TypeScript config file in Docusaurus, unless you
 
 We recommend using [JSDoc type annotations](https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html):
 
-<!-- prettier-ignore-start -->
 ```js title="docusaurus.config.js"
+// highlight-start
+// @ts-check
+// highlight-end
+
 // highlight-start
 /** @type {import('@docusaurus/types').Plugin} */
 // highlight-end
@@ -54,9 +57,9 @@ function MyPlugin(context, options) {
 }
 
 // highlight-start
-/** @type {import('@docusaurus/types').DocusaurusConfig} */
+/** @type {import('@docusaurus/types').Config} */
 // highlight-end
-(module.exports = {
+const config = {
   title: 'Docusaurus',
   tagline: 'Build optimized websites quickly, focus on your content',
   organizationName: 'facebook',
@@ -98,9 +101,10 @@ function MyPlugin(context, options) {
         },
       },
     }),
-});
+};
+
+module.exports = config;
 ```
-<!-- prettier-ignore-end -->
 
 :::tip
 
@@ -110,6 +114,18 @@ The best IDEs (VSCode, WebStorm, Intellij...) will provide a nice auto-completio
 
 :::
 
+:::info
+
+By default, the Docusaurus TypeScript config does not type-check JavaScript files.
+
+The `// @ts-check` comment ensures the config file is properly type-checked when running:
+
+```bash npm2yarn
+npm run tsc
+```
+
+:::
+
 ## Swizzling TypeScript theme components {#swizzling-typescript-theme-components}
 
 For themes that supports TypeScript theme components, you can add the `--typescript` flag to the end of swizzling command to get TypeScript source code. For example, the following command will generate `index.tsx` and `styles.module.css` into `src/theme/Footer`.
diff --git a/website/versioned_docs/version-2.0.0-beta.6/using-plugins.md b/website/versioned_docs/version-2.0.0-beta.8/using-plugins.md
similarity index 99%
rename from website/versioned_docs/version-2.0.0-beta.6/using-plugins.md
rename to website/versioned_docs/version-2.0.0-beta.8/using-plugins.md
index 2ebef9f490..308a8c8266 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/using-plugins.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/using-plugins.md
@@ -133,7 +133,7 @@ You can use a plugin as a function, directly in the Docusaurus config file:
 module.exports = {
   // ...
   plugins: [
-    // highligh-start
+    // highlight-start
     function myPlugin(context, options) {
       // ...
       return {
diff --git a/website/versioned_docs/version-2.0.0-beta.6/using-themes.md b/website/versioned_docs/version-2.0.0-beta.8/using-themes.md
similarity index 99%
rename from website/versioned_docs/version-2.0.0-beta.6/using-themes.md
rename to website/versioned_docs/version-2.0.0-beta.8/using-themes.md
index f0f94a959f..2ff65c35ee 100644
--- a/website/versioned_docs/version-2.0.0-beta.6/using-themes.md
+++ b/website/versioned_docs/version-2.0.0-beta.8/using-themes.md
@@ -51,7 +51,7 @@ website
 
 `website/src/theme/Navbar.js` takes precedence whenever `@theme/Navbar` is imported. This behavior is called component swizzling. In iOS, method swizzling is the process of changing the implementation of an existing selector (method). In the context of a website, component swizzling means providing an alternative component that takes precedence over the component provided by the theme.
 
-**Themes are for providing UI components to present the content.** Most content plugins need to be paired with a theme in order to be actually useful. The UI is a separate layer from the data schema, so it makes it easy to swap out the themes for other designs (i.e., Bootstrap).
+**Themes are for providing UI components to present the content.** Most content plugins need to be paired with a theme in order to be actually useful. The UI is a separate layer from the data schema, so it makes it easy to swap out the themes for other designs.
 
 For example, a Docusaurus blog consists of a blog plugin and a blog theme.
 
diff --git a/website/versioned_sidebars/version-2.0.0-beta.6-sidebars.json b/website/versioned_sidebars/version-2.0.0-beta.8-sidebars.json
similarity index 55%
rename from website/versioned_sidebars/version-2.0.0-beta.6-sidebars.json
rename to website/versioned_sidebars/version-2.0.0-beta.8-sidebars.json
index edb9fee7ea..da77d4031b 100644
--- a/website/versioned_sidebars/version-2.0.0-beta.6-sidebars.json
+++ b/website/versioned_sidebars/version-2.0.0-beta.8-sidebars.json
@@ -1,8 +1,8 @@
 {
-  "version-2.0.0-beta.6/docs": [
+  "version-2.0.0-beta.8/docs": [
     {
       "type": "doc",
-      "id": "version-2.0.0-beta.6/introduction"
+      "id": "version-2.0.0-beta.8/introduction"
     },
     {
       "type": "category",
@@ -11,19 +11,19 @@
       "items": [
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/installation"
+          "id": "version-2.0.0-beta.8/installation"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/configuration"
+          "id": "version-2.0.0-beta.8/configuration"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/playground"
+          "id": "version-2.0.0-beta.8/playground"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/typescript-support"
+          "id": "version-2.0.0-beta.8/typescript-support"
         }
       ],
       "collapsible": true
@@ -34,7 +34,7 @@
       "items": [
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/guides/creating-pages"
+          "id": "version-2.0.0-beta.8/guides/creating-pages"
         },
         {
           "type": "category",
@@ -44,33 +44,33 @@
           "items": [
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/docs/introduction"
+              "id": "version-2.0.0-beta.8/guides/docs/introduction"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/docs/create-doc"
+              "id": "version-2.0.0-beta.8/guides/docs/create-doc"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/docs/sidebar"
+              "id": "version-2.0.0-beta.8/guides/docs/sidebar"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/docs/versioning"
+              "id": "version-2.0.0-beta.8/guides/docs/versioning"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/docs/markdown-features"
+              "id": "version-2.0.0-beta.8/guides/docs/markdown-features"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/docs/multi-instance"
+              "id": "version-2.0.0-beta.8/guides/docs/multi-instance"
             }
           ]
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/blog"
+          "id": "version-2.0.0-beta.8/blog"
         },
         {
           "type": "category",
@@ -78,47 +78,47 @@
           "items": [
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/introduction"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/introduction"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/react"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/react"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/tabs"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/tabs"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/code-blocks"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/code-blocks"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/admonitions"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/admonitions"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/headings"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/headings"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/inline-toc"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/inline-toc"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/assets"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/assets"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/plugins"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/plugins"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/math-equations"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/math-equations"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/guides/markdown-features/head-metadatas"
+              "id": "version-2.0.0-beta.8/guides/markdown-features/head-metadatas"
             }
           ],
           "collapsible": true,
@@ -126,23 +126,23 @@
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/styling-layout"
+          "id": "version-2.0.0-beta.8/styling-layout"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/static-assets"
+          "id": "version-2.0.0-beta.8/static-assets"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/search"
+          "id": "version-2.0.0-beta.8/search"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/browser-support"
+          "id": "version-2.0.0-beta.8/browser-support"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/deployment"
+          "id": "version-2.0.0-beta.8/deployment"
         },
         {
           "type": "category",
@@ -150,19 +150,19 @@
           "items": [
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/i18n/introduction"
+              "id": "version-2.0.0-beta.8/i18n/introduction"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/i18n/tutorial"
+              "id": "version-2.0.0-beta.8/i18n/tutorial"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/i18n/git"
+              "id": "version-2.0.0-beta.8/i18n/git"
             },
             {
               "type": "doc",
-              "id": "version-2.0.0-beta.6/i18n/crowdin"
+              "id": "version-2.0.0-beta.8/i18n/crowdin"
             }
           ],
           "collapsible": true,
@@ -178,15 +178,15 @@
       "items": [
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/using-plugins"
+          "id": "version-2.0.0-beta.8/using-plugins"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/using-themes"
+          "id": "version-2.0.0-beta.8/using-themes"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/presets"
+          "id": "version-2.0.0-beta.8/presets"
         }
       ],
       "collapsible": true,
@@ -198,45 +198,45 @@
       "items": [
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/migration/migration-overview"
+          "id": "version-2.0.0-beta.8/migration/migration-overview"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/migration/migration-automated"
+          "id": "version-2.0.0-beta.8/migration/migration-automated"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/migration/migration-manual"
+          "id": "version-2.0.0-beta.8/migration/migration-manual"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/migration/migration-versioned-sites"
+          "id": "version-2.0.0-beta.8/migration/migration-versioned-sites"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/migration/migration-translated-sites"
+          "id": "version-2.0.0-beta.8/migration/migration-translated-sites"
         }
       ],
       "collapsible": true,
       "collapsed": true
     }
   ],
-  "version-2.0.0-beta.6/api": [
+  "version-2.0.0-beta.8/api": [
     {
       "type": "doc",
-      "id": "version-2.0.0-beta.6/cli"
+      "id": "version-2.0.0-beta.8/cli"
     },
     {
       "type": "doc",
-      "id": "version-2.0.0-beta.6/docusaurus-core"
+      "id": "version-2.0.0-beta.8/docusaurus-core"
     },
     {
       "type": "doc",
-      "id": "version-2.0.0-beta.6/api/docusaurus.config.js"
+      "id": "version-2.0.0-beta.8/api/docusaurus.config.js"
     },
     {
       "type": "doc",
-      "id": "version-2.0.0-beta.6/lifecycle-apis"
+      "id": "version-2.0.0-beta.8/lifecycle-apis"
     },
     {
       "type": "category",
@@ -244,47 +244,47 @@
       "items": [
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugins-overview"
+          "id": "version-2.0.0-beta.8/api/plugins/plugins-overview"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-content-docs"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-content-docs"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-content-blog"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-content-blog"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-content-pages"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-content-pages"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-client-redirects"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-client-redirects"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-debug"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-debug"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-google-analytics"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-google-analytics"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-google-gtag"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-google-gtag"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-ideal-image"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-ideal-image"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-pwa"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-pwa"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/plugins/plugin-sitemap"
+          "id": "version-2.0.0-beta.8/api/plugins/plugin-sitemap"
         }
       ],
       "collapsible": true,
@@ -296,27 +296,23 @@
       "items": [
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/themes/themes-overview"
+          "id": "version-2.0.0-beta.8/api/themes/themes-overview"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/themes/theme-configuration"
+          "id": "version-2.0.0-beta.8/api/themes/theme-configuration"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/themes/theme-classic"
+          "id": "version-2.0.0-beta.8/api/themes/theme-classic"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/themes/theme-bootstrap"
+          "id": "version-2.0.0-beta.8/api/themes/theme-live-codeblock"
         },
         {
           "type": "doc",
-          "id": "version-2.0.0-beta.6/api/themes/theme-live-codeblock"
-        },
-        {
-          "type": "doc",
-          "id": "version-2.0.0-beta.6/api/themes/theme-search-algolia"
+          "id": "version-2.0.0-beta.8/api/themes/theme-search-algolia"
         }
       ],
       "collapsible": true,
diff --git a/website/versions.json b/website/versions.json
index c9e89b3f44..2281562225 100644
--- a/website/versions.json
+++ b/website/versions.json
@@ -1,4 +1,4 @@
 [
-  "2.0.0-beta.7",
-  "2.0.0-beta.6"
+  "2.0.0-beta.8",
+  "2.0.0-beta.7"
 ]
diff --git a/website/versionsArchived.json b/website/versionsArchived.json
index 1e0ad91472..1850d48c6b 100644
--- a/website/versionsArchived.json
+++ b/website/versionsArchived.json
@@ -1,5 +1,6 @@
 {
-  "2.0.0-beta.5": "https://6130eb5cde15830007fdf57b--docusaurus-2.netlify.app/docs",
+  "2.0.0-beta.6": "https://61716a75858b7d0007e84c89--docusaurus-2.netlify.app/docs/2.0.0-beta.6",
+  "2.0.0-beta.5": "https://61685d5327709b0007411bff--docusaurus-2.netlify.app/docs/2.0.0-beta.5",
   "2.0.0-beta.4": "https://6130eb5cde15830007fdf57b--docusaurus-2.netlify.app/docs/2.0.0-beta.4",
   "2.0.0-beta.3": "https://6127899cbdc82400074cdc97--docusaurus-2.netlify.app/docs/2.0.0-beta.3",
   "2.0.0-beta.2": "https://6107be93ef38a00008efa7eb--docusaurus-2.netlify.app/docs/2.0.0-beta.2",