chore: release v3.5.1 (#10385)

website/versioned_docs/version-3.5.1/api/themes/_category_.yml

@@ -0,0 +1,5 @@
+label: Themes
+position: 3
+link:
+  type: doc
+  id: themes-overview # Dogfood using a "local id"

website/versioned_docs/version-3.5.1/api/themes/overview.mdx

@@ -0,0 +1,34 @@
+---
+sidebar_position: 0
+id: themes-overview
+sidebar_label: Themes overview
+slug: /api/themes
+---
+
+# Docusaurus themes
+
+We provide official Docusaurus themes.
+
+## Main themes {#main-themes}
+
+The main themes implement the user interface for the [docs](../plugins/plugin-content-docs.mdx), [blog](../plugins/plugin-content-blog.mdx) and [pages](../plugins/plugin-content-pages.mdx) plugins.
+
+- [@docusaurus/theme-classic](./theme-classic.mdx)
+- 🚧 other themes are planned
+
+:::warning
+
+The goal is to have all themes share the exact same features, user-experience and configuration.
+
+Only the UI design and underlying styling framework should change, and you should be able to change theme easily.
+
+We are not there yet: only the classic theme is production ready.
+
+:::
+
+## Enhancement themes {#enhancement-themes}
+
+These themes will enhance the existing main themes with additional user-interface related features.
+
+- [@docusaurus/theme-live-codeblock](./theme-live-codeblock.mdx)
+- [@docusaurus/theme-search-algolia](./theme-search-algolia.mdx)

website/versioned_docs/version-3.5.1/api/themes/theme-classic.mdx

@@ -0,0 +1,63 @@
+---
+sidebar_position: 2
+slug: /api/themes/@docusaurus/theme-classic
+---
+
+# 📦 theme-classic
+
+import APITable from '@site/src/components/APITable';
+
+The classic theme for Docusaurus.
+
+You can refer to the [theme configuration page](theme-configuration.mdx) for more details on the configuration.
+
+```bash npm2yarn
+npm install --save @docusaurus/theme-classic
+```
+
+:::tip
+
+If you have installed `@docusaurus/preset-classic`, you don't need to install it as a dependency.
+
+:::
+
+## Configuration {#configuration}
+
+Accepted fields:
+
+```mdx-code-block
+<APITable>
+```
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `customCss` | <code>string[] \| string</code> | `[]` | Stylesheets to be imported globally as [client modules](../../advanced/client.mdx#client-modules). Relative paths are resolved against the site directory. |
+
+```mdx-code-block
+</APITable>
+```
+
+:::note
+
+Most configuration for the theme is done in `themeConfig`, which can be found in [theme configuration](./theme-configuration.mdx).
+
+:::
+
+### Example configuration {#ex-config}
+
+You can configure this theme through preset options or plugin options.
+
+:::tip
+
+Most Docusaurus users configure this plugin through the preset options.
+
+:::
+
+```js config-tabs
+// Preset Options: theme
+// Plugin Options: @docusaurus/theme-classic
+
+const config = {
+  customCss: './src/css/custom.css',
+};
+```

website/versioned_docs/version-3.5.1/api/themes/theme-live-codeblock.mdx

@@ -0,0 +1,29 @@
+---
+sidebar_position: 3
+slug: /api/themes/@docusaurus/theme-live-codeblock
+---
+
+# 📦 theme-live-codeblock
+
+This theme provides a `@theme/CodeBlock` component that is powered by react-live. You can read more on [interactive code editor](../../guides/markdown-features/markdown-features-code-blocks.mdx#interactive-code-editor) documentation.
+
+```bash npm2yarn
+npm install --save @docusaurus/theme-live-codeblock
+```
+
+### Configuration {#configuration}
+
+```js title="docusaurus.config.js"
+export default {
+  plugins: ['@docusaurus/theme-live-codeblock'],
+  themeConfig: {
+    liveCodeBlock: {
+      /**
+       * The position of the live playground, above or under the editor
+       * Possible values: "top" | "bottom"
+       */
+      playgroundPosition: 'bottom',
+    },
+  },
+};
+```

website/versioned_docs/version-3.5.1/api/themes/theme-mermaid.mdx

@@ -0,0 +1,25 @@
+---
+sidebar_position: 5
+slug: /api/themes/@docusaurus/theme-mermaid
+---
+
+# 📦 theme-mermaid
+
+This theme provides a `@theme/Mermaid` component that is powered by [mermaid](https://mermaid-js.github.io/). You can read more on [diagrams](../../guides/markdown-features/markdown-features-diagrams.mdx) documentation.
+
+```bash npm2yarn
+npm install --save @docusaurus/theme-mermaid
+```
+
+## Configuration {#configuration}
+
+```js title="docusaurus.config.js"
+export default {
+  themes: ['@docusaurus/theme-mermaid'],
+  // In order for Mermaid code blocks in Markdown to work,
+  // you also need to enable the Remark plugin with this option
+  markdown: {
+    mermaid: true,
+  },
+};
+```

website/versioned_docs/version-3.5.1/api/themes/theme-search-algolia.mdx

@@ -0,0 +1,20 @@
+---
+sidebar_position: 4
+slug: /api/themes/@docusaurus/theme-search-algolia
+---
+
+# 📦 theme-search-algolia
+
+This theme provides a `@theme/SearchBar` component that integrates with Algolia DocSearch easily. Combined with `@docusaurus/theme-classic`, it provides a very easy search integration. You can read more on [search](../../search.mdx) documentation.
+
+```bash npm2yarn
+npm install --save @docusaurus/theme-search-algolia
+```
+
+This theme also adds search page available at `/search` (as swizzlable `SearchPage` component) path with OpenSearch support. You can change this default path via `themeConfig.algolia.searchPagePath`. Use `false` to disable search page.
+
+:::tip
+
+If you have installed `@docusaurus/preset-classic`, you don't need to install it as a dependency.
+
+:::