diff --git a/CHANGELOG.md b/CHANGELOG.md
index f0738d5c0f64..3d3c27cf1bdf 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,63 @@
# Docusaurus 2 Changelog
+## 2.0.0-beta.6 (2021-09-02)
+
+#### :rocket: New Feature
+
+- `docusaurus-plugin-content-blog`, `docusaurus-theme-classic`
+ - [#5428](https://github.com/facebook/docusaurus/pull/5428) feat: adds blog archive route ([@gabrielcsapo](https://github.com/gabrielcsapo))
+- `docusaurus-theme-classic`, `docusaurus-theme-common`
+ - [#5462](https://github.com/facebook/docusaurus/pull/5462) feat: on back navigation, close mobile sidebar ([@slorber](https://github.com/slorber))
+ - [#5445](https://github.com/facebook/docusaurus/pull/5445) feat: Add docs-related stable classnames ([@slorber](https://github.com/slorber))
+- `docusaurus-theme-classic`
+ - [#5460](https://github.com/facebook/docusaurus/pull/5460) feat: infima 33 + navbar-sidebar close button ([@slorber](https://github.com/slorber))
+ - [#5442](https://github.com/facebook/docusaurus/pull/5442) feat(theme-classic): allow passing tab label and default value through TabItem ([@Josh-Cena](https://github.com/Josh-Cena))
+- `docusaurus-plugin-content-docs`, `docusaurus-theme-classic`
+ - [#5454](https://github.com/facebook/docusaurus/pull/5454) feat: new docs options: versions.{badge,className} ([@slorber](https://github.com/slorber))
+
+#### :bug: Bug Fix
+
+- `docusaurus-theme-classic`
+ - [#5444](https://github.com/facebook/docusaurus/pull/5444) fix: fix some theme UI issues (blockquotes, navbar-sidebar font) with Infima alpha.32 ([@slorber](https://github.com/slorber))
+ - [#5431](https://github.com/facebook/docusaurus/pull/5431) fix: some beta.5 bugfixes ([@slorber](https://github.com/slorber))
+- `docusaurus-init`, `docusaurus-mdx-loader`, `docusaurus-plugin-content-blog`, `docusaurus-plugin-content-docs`, `docusaurus-theme-classic`
+ - [#5437](https://github.com/facebook/docusaurus/pull/5437) fix: fix a few TS errors ([@Josh-Cena](https://github.com/Josh-Cena))
+
+#### :nail_care: Polish
+
+- `docusaurus-plugin-content-docs`, `docusaurus-theme-classic`
+ - [#5459](https://github.com/facebook/docusaurus/pull/5459) refactor(theme-classic): completely migrate package to TypeScript ([@Josh-Cena](https://github.com/Josh-Cena))
+- `docusaurus-theme-classic`
+ - [#5453](https://github.com/facebook/docusaurus/pull/5453) refactor: use SVG for closable button in announcement bar ([@lex111](https://github.com/lex111))
+ - [#5430](https://github.com/facebook/docusaurus/pull/5430) refactor: switch to Flexbox in announcement bar ([@lex111](https://github.com/lex111))
+ - [#5434](https://github.com/facebook/docusaurus/pull/5434) refactor: update Arabic and Persian translations ([@3alisaki](https://github.com/3alisaki))
+ - [#5410](https://github.com/facebook/docusaurus/pull/5410) refactor: add missing translations in fa.json ([@farshidinanloo](https://github.com/farshidinanloo))
+
+#### :memo: Documentation
+
+- [#5471](https://github.com/facebook/docusaurus/pull/5471) docs: Add docusaurus-plugin-relative-paths ([@ohkimur](https://github.com/ohkimur))
+- [#5464](https://github.com/facebook/docusaurus/pull/5464) docs: add mapillary-js to showcase ([@oscarlorentzon](https://github.com/oscarlorentzon))
+- [#5433](https://github.com/facebook/docusaurus/pull/5433) docs: document doc tags + refinements ([@Josh-Cena](https://github.com/Josh-Cena))
+- [#5435](https://github.com/facebook/docusaurus/pull/5435) docs: Add netboot.xyz to site showcase ([@antonym](https://github.com/antonym))
+- [#5436](https://github.com/facebook/docusaurus/pull/5436) docs: add Redocusaurus in community plugin list ([@rohit-gohri](https://github.com/rohit-gohri))
+
+#### :house: Internal
+
+- [#5455](https://github.com/facebook/docusaurus/pull/5455) fix: website bad version name in docusaurus.config.js ([@slorber](https://github.com/slorber))
+
+#### Committers: 10
+
+- Alexey Pyltsyn ([@lex111](https://github.com/lex111))
+- Ali Saki ([@3alisaki](https://github.com/3alisaki))
+- Antony Messerli ([@antonym](https://github.com/antonym))
+- Daniel Costrasel ([@ohkimur](https://github.com/ohkimur))
+- Gabriel Csapo ([@gabrielcsapo](https://github.com/gabrielcsapo))
+- Joshua Chen ([@Josh-Cena](https://github.com/Josh-Cena))
+- Oscar Lorentzon ([@oscarlorentzon](https://github.com/oscarlorentzon))
+- Rohit Gohri ([@rohit-gohri](https://github.com/rohit-gohri))
+- SΓ©bastien Lorber ([@slorber](https://github.com/slorber))
+- farshid ([@farshidinanloo](https://github.com/farshidinanloo))
+
## 2.0.0-beta.5 (2021-08-26)
#### :rocket: New Feature
diff --git a/website/versioned_docs/version-2.0.0-beta.6/_partials/swizzleWarning.mdx b/website/versioned_docs/version-2.0.0-beta.6/_partials/swizzleWarning.mdx
new file mode 100644
index 000000000000..e2aec479dd28
--- /dev/null
+++ b/website/versioned_docs/version-2.0.0-beta.6/_partials/swizzleWarning.mdx
@@ -0,0 +1,5 @@
+:::caution
+
+We discourage swizzling of components during the Docusaurus 2 beta phase. The theme components APIs are likely to evolve and have breaking changes. If possible, stick with the default appearance for now.
+
+:::
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.6/api/docusaurus.config.js.md
new file mode 100644
index 000000000000..c2204357ed91
--- /dev/null
+++ b/website/versioned_docs/version-2.0.0-beta.6/api/docusaurus.config.js.md
@@ -0,0 +1,490 @@
+---
+id: docusaurus.config.js
+description: API reference for Docusaurus configuration file.
+slug: /docusaurus.config.js
+---
+
+# `docusaurus.config.js`
+
+## Overview {#overview}
+
+`docusaurus.config.js` contains configurations for your site and is placed in the root directory of your site.
+
+## Required fields {#required-fields}
+
+### `title` {#title}
+
+- Type: `string`
+
+Title for your website.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ title: 'Docusaurus',
+};
+```
+
+### `url` {#url}
+
+- Type: `string`
+
+URL for your website. This can also be considered the top-level hostname. For example, `https://facebook.github.io` is the URL of https://facebook.github.io/metro/, and `https://docusaurus.io` is the URL for https://docusaurus.io. This field is related to the [baseUrl](#baseurl) field.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ url: 'https://docusaurus.io',
+};
+```
+
+### `baseUrl` {#baseurl}
+
+- Type: `string`
+
+Base URL for your site. This can also be considered the path after the host. For example, `/metro/` is the baseUrl of https://facebook.github.io/metro/. For URLs that have no path, the baseUrl should be set to `/`. This field is related to the [url](#url) field.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ baseUrl: '/',
+};
+```
+
+## Optional fields {#optional-fields}
+
+### `favicon` {#favicon}
+
+- Type: `string | undefined`
+
+Path to your site favicon
+
+Example, if your favicon is in `static/img/favicon.ico`:
+
+```js title="docusaurus.config.js"
+module.exports = {
+ favicon: '/img/favicon.ico',
+};
+```
+
+### `trailingSlash` {#trailing-slash}
+
+- Type: `boolean | undefined`
+
+Allow to customize the presence/absence of a trailing slash at the end of URLs/links, and how static HTML files are generated:
+
+- `undefined` (default): keeps URLs untouched, and emit `/docs/myDoc/index.html` for `/docs/myDoc.md`
+- `true`: add trailing slashes to URLs/links, and emit `/docs/myDoc/index.html` for `/docs/myDoc.md`
+- `false`: remove trailing slashes from URLs/links, and emit `/docs/myDoc.html` for `/docs/myDoc.md`
+
+:::tip
+
+Each static hosting provider serve static files differently (this behavior may even change over time).
+
+Refer to the [deployment guide](../deployment.mdx) and [slorber/trailing-slash-guide](https://github.com/slorber/trailing-slash-guide) to choose the appropriate setting.
+
+:::
+
+### `i18n` {#i18n}
+
+- Type: `Object`
+
+The i18n configuration object to [localize your site](../i18n/i18n-introduction.md).
+
+Example:
+
+```js title="docusaurus.config.js"
+module.exports = {
+ i18n: {
+ defaultLocale: 'en',
+ locales: ['en', 'fr'],
+ localeConfigs: {
+ en: {
+ label: 'English',
+ direction: 'ltr',
+ },
+ fr: {
+ label: 'Français',
+ direction: 'ltr',
+ },
+ },
+ },
+};
+```
+
+- `label`: the label to use for this locale
+- `direction`: `ltr` (default) or `rtl` (for [right-to-left languages](https://developer.mozilla.org/en-US/docs/Glossary/rtl) like Araric, Hebrew, etc.)
+
+### `noIndex` {#noindex}
+
+- Type: `boolean`
+
+This option adds `` in pages, to tell search engines to avoid indexing your site (more information [here](https://moz.com/learn/seo/robots-meta-directives)).
+
+Example:
+
+```js title="docusaurus.config.js"
+module.exports = {
+ noIndex: true, // Defaults to `false`
+};
+```
+
+### `onBrokenLinks` {#onbrokenlinks}
+
+- Type: `'ignore' | 'log' | 'warn' | 'error' | 'throw'`
+
+The behavior of Docusaurus, when it detects any broken link.
+
+By default, it throws an error, to ensure you never ship any broken link, but you can lower this security if needed.
+
+:::note
+
+The broken links detection is only available for a production build (`docusaurus build`).
+
+:::
+
+### `onBrokenMarkdownLinks` {#onbrokenmarkdownlinks}
+
+- Type: `'ignore' | 'log' | 'warn' | 'error' | 'throw'`
+
+The behavior of Docusaurus, when it detects any broken markdown link.
+
+By default, it prints a warning, to let you know about your broken markdown link, but you can change this security if needed.
+
+### `onDuplicateRoutes` {#onduplicateroutes}
+
+- Type: `'ignore' | 'log' | 'warn' | 'error' | 'throw'`
+
+The behavior of Docusaurus when it detects any [duplicate routes](/guides/creating-pages.md#duplicate-routes).
+
+By default, it displays a warning after you run `yarn start` or `yarn build`.
+
+### `tagline` {#tagline}
+
+- Type: `string`
+
+The tagline for your website.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ tagline:
+ 'Docusaurus makes it easy to maintain Open Source documentation websites.',
+};
+```
+
+### `organizationName` {#organizationname}
+
+- Type: `string`
+
+The GitHub user or organization that owns the repository. Used by the deployment command.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ // Docusaurus' organization is facebook
+ organizationName: 'facebook',
+};
+```
+
+### `projectName` {#projectname}
+
+- Type: `string`
+
+The name of the GitHub repository. Used by the deployment command.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ projectName: 'docusaurus',
+};
+```
+
+### `githubHost` {#githubhost}
+
+- Type: `string`
+
+The hostname of your server. Useful if you are using GitHub Enterprise.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ githubHost: 'github.com',
+};
+```
+
+### `githubPort` {#githubPort}
+
+- Type: `string`
+
+The port of your server. Useful if you are using GitHub Enterprise.
+
+```js title="docusaurus.config.js"
+module.exports = {
+ githubPort: '22',
+};
+```
+
+### `themeConfig` {#themeconfig}
+
+- Type: `Object`
+
+The [theme configuration](./themes/theme-configuration.md) object, to customize your site UI like navbar, footer.
+
+Example:
+
+```js title="docusaurus.config.js"
+module.exports = {
+ themeConfig: {
+ hideableSidebar: false,
+ colorMode: {
+ defaultMode: 'light',
+ disableSwitch: false,
+ respectPrefersColorScheme: true,
+ switchConfig: {
+ darkIcon: 'π',
+ lightIcon: '\u2600',
+ // React inline style object
+ // see https://reactjs.org/docs/dom-elements.html#style
+ darkIconStyle: {
+ marginLeft: '2px',
+ },
+ lightIconStyle: {
+ marginLeft: '1px',
+ },
+ },
+ },
+ navbar: {
+ title: 'Site Title',
+ logo: {
+ alt: 'Site Logo',
+ src: 'img/logo.svg',
+ },
+ items: [
+ {
+ to: 'docs/docusaurus.config.js',
+ activeBasePath: 'docs',
+ label: 'docusaurus.config.js',
+ position: 'left',
+ },
+ // ... other links
+ ],
+ },
+ footer: {
+ style: 'dark',
+ links: [
+ {
+ title: 'Docs',
+ items: [
+ {
+ label: 'Docs',
+ to: 'docs/doc1',
+ },
+ ],
+ },
+ // ... other links
+ ],
+ logo: {
+ alt: 'Facebook Open Source Logo',
+ src: 'https://docusaurus.io/img/oss_logo.png',
+ },
+ copyright: `Copyright Β© ${new Date().getFullYear()} Facebook, Inc.`, // You can also put own HTML here
+ },
+ },
+};
+```
+
+### `plugins` {#plugins}
+
+
+
+- Type: `any[]`
+
+```js title="docusaurus.config.js"
+module.exports = {
+ plugins: [],
+};
+```
+
+### `themes` {#themes}
+
+
+
+- Type: `any[]`
+
+```js title="docusaurus.config.js"
+module.exports = {
+ themes: [],
+};
+```
+
+### `presets` {#presets}
+
+
+
+- Type: `any[]`
+
+```js title="docusaurus.config.js"
+module.exports = {
+ presets: [],
+};
+```
+
+### `customFields` {#customfields}
+
+Docusaurus guards `docusaurus.config.js` from unknown fields. To add a custom field, define it on `customFields`.
+
+- Type: `Object`
+
+```js title="docusaurus.config.js"
+module.exports = {
+ customFields: {
+ admin: 'endi',
+ superman: 'lol',
+ },
+};
+```
+
+Attempting to add unknown field in the config will lead to error in build time:
+
+```bash
+Error: The field(s) 'foo', 'bar' are not recognized in docusaurus.config.js
+```
+
+### `scripts` {#scripts}
+
+An array of scripts to load. The values can be either strings or plain objects of attribute-value maps. The `
+ <% }); %>
+ <%~ it.postBodyTags %>
+