From f5ae537d3ec6b2745957b14ead890187c70b302f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= Date: Fri, 15 Sep 2023 10:48:21 +0200 Subject: [PATCH] fix(theme): make warning a first-class admonition, and deprecate caution admonition (#9308) --- package.json | 3 +- .../src/getSwizzleConfig.ts | 22 ++++--- .../src/theme-classic.d.ts | 13 +++- .../Icon/{Caution.tsx => Warning.tsx} | 2 +- .../src/theme/Admonition/Type/Caution.tsx | 6 +- .../src/theme/Admonition/Type/Warning.tsx | 37 ++++++++++++ .../src/theme/Admonition/Types.tsx | 8 +-- .../locales/ar/theme-common.json | 1 + .../locales/base/theme-common.json | 5 +- .../locales/bn/theme-common.json | 1 + .../locales/cs/theme-common.json | 1 + .../locales/da/theme-common.json | 1 + .../locales/de/theme-common.json | 1 + .../locales/es/theme-common.json | 1 + .../locales/fa/theme-common.json | 1 + .../locales/fil/theme-common.json | 1 + .../locales/fr/theme-common.json | 1 + .../locales/he/theme-common.json | 1 + .../locales/hi/theme-common.json | 1 + .../locales/hu/theme-common.json | 5 +- .../locales/hu/theme-search-algolia.json | 4 +- .../locales/it/theme-common.json | 1 + .../locales/ja/theme-common.json | 1 + .../locales/ko/theme-common.json | 1 + .../locales/nb/theme-common.json | 1 + .../locales/nl/theme-common.json | 1 + .../locales/pl/theme-common.json | 1 + .../locales/pt-BR/theme-common.json | 1 + .../locales/pt-PT/theme-common.json | 1 + .../locales/ru/theme-common.json | 1 + .../locales/sl/theme-common.json | 1 + .../locales/sr/theme-common.json | 1 + .../locales/sv/theme-common.json | 1 + .../locales/tr/theme-common.json | 1 + .../locales/uk/theme-common.json | 1 + .../locales/vi/theme-common.json | 1 + .../locales/zh-Hans/theme-common.json | 1 + .../locales/zh-Hant/theme-common.json | 1 + .../_docs tests/tests/admonitions.mdx | 60 +++++++++++++++++++ .../_pages tests/markdown-tests-mdx.mdx | 4 +- website/blog/releases/2.3/index.mdx | 2 +- website/blog/releases/2.4/index.mdx | 2 +- website/community/4-canary.mdx | 4 +- website/community/5-release-process.mdx | 2 +- website/docs/advanced/client.mdx | 2 +- website/docs/advanced/ssg.mdx | 2 +- website/docs/api/docusaurus.config.js.mdx | 2 +- website/docs/api/misc/create-docusaurus.mdx | 2 +- website/docs/api/misc/logger/logger.mdx | 2 +- website/docs/api/plugin-methods/README.mdx | 2 +- .../plugin-methods/extend-infrastructure.mdx | 2 +- .../api/plugin-methods/lifecycle-apis.mdx | 4 +- .../api/plugins/plugin-client-redirects.mdx | 4 +- .../docs/api/plugins/plugin-content-blog.mdx | 2 +- .../api/plugins/plugin-google-analytics.mdx | 2 +- .../docs/api/plugins/plugin-google-gtag.mdx | 2 +- .../api/plugins/plugin-google-tag-manager.mdx | 2 +- .../docs/api/plugins/plugin-ideal-image.mdx | 2 +- website/docs/api/plugins/plugin-pwa.mdx | 4 +- website/docs/api/plugins/plugin-sitemap.mdx | 2 +- website/docs/api/themes/overview.mdx | 2 +- .../docs/api/themes/theme-configuration.mdx | 2 +- website/docs/blog.mdx | 4 +- website/docs/browser-support.mdx | 2 +- website/docs/cli.mdx | 4 +- website/docs/deployment.mdx | 6 +- website/docs/docusaurus-core.mdx | 8 +-- website/docs/guides/creating-pages.mdx | 2 +- .../docs/guides/docs/docs-introduction.mdx | 2 +- .../docs/guides/docs/docs-multi-instance.mdx | 4 +- .../guides/docs/sidebar/autogenerated.mdx | 2 +- website/docs/guides/docs/sidebar/items.mdx | 2 +- website/docs/guides/docs/versioning.mdx | 2 +- .../markdown-features-admonitions.mdx | 8 +-- .../markdown-features-code-blocks.mdx | 8 +-- .../markdown-features-math-equations.mdx | 2 +- .../markdown-features-plugins.mdx | 2 +- .../markdown-features-react.mdx | 6 +- .../markdown-features-toc.mdx | 4 +- website/docs/i18n/i18n-crowdin.mdx | 12 ++-- website/docs/i18n/i18n-tutorial.mdx | 10 ++-- website/docs/migration/migration-manual.mdx | 2 +- .../migration/migration-translated-sites.mdx | 4 +- website/docs/search.mdx | 2 +- website/docs/seo.mdx | 2 +- website/docs/static-assets.mdx | 2 +- website/docs/styling-layout.mdx | 2 +- website/docs/swizzling.mdx | 2 +- .../version-2.0.1/advanced/client.mdx | 2 +- .../version-2.0.1/advanced/ssg.mdx | 2 +- .../api/docusaurus.config.js.mdx | 2 +- .../api/misc/create-docusaurus.mdx | 2 +- .../version-2.0.1/api/misc/logger/logger.mdx | 2 +- .../api/plugin-methods/README.mdx | 2 +- .../plugin-methods/extend-infrastructure.mdx | 2 +- .../api/plugin-methods/lifecycle-apis.mdx | 4 +- .../api/plugins/plugin-client-redirects.mdx | 4 +- .../api/plugins/plugin-content-blog.mdx | 2 +- .../api/plugins/plugin-google-analytics.mdx | 2 +- .../api/plugins/plugin-google-gtag.mdx | 2 +- .../version-2.0.1/api/plugins/plugin-pwa.mdx | 4 +- .../api/plugins/plugin-sitemap.mdx | 2 +- .../version-2.0.1/api/themes/overview.mdx | 2 +- .../api/themes/theme-configuration.mdx | 2 +- website/versioned_docs/version-2.0.1/blog.mdx | 4 +- .../version-2.0.1/browser-support.mdx | 2 +- website/versioned_docs/version-2.0.1/cli.mdx | 4 +- .../version-2.0.1/deployment.mdx | 6 +- .../version-2.0.1/docusaurus-core.mdx | 8 +-- .../version-2.0.1/guides/creating-pages.mdx | 2 +- .../guides/docs/docs-introduction.mdx | 2 +- .../guides/docs/docs-multi-instance.mdx | 4 +- .../guides/docs/sidebar/autogenerated.mdx | 2 +- .../guides/docs/sidebar/items.mdx | 2 +- .../version-2.0.1/guides/docs/versioning.mdx | 2 +- .../markdown-features-code-blocks.mdx | 8 +-- .../markdown-features-intro.mdx | 2 +- .../markdown-features-math-equations.mdx | 2 +- .../markdown-features-react.mdx | 6 +- .../markdown-features-toc.mdx | 4 +- .../version-2.0.1/i18n/i18n-crowdin.mdx | 12 ++-- .../version-2.0.1/i18n/i18n-tutorial.mdx | 10 ++-- .../migration/migration-manual.mdx | 2 +- .../migration/migration-translated-sites.mdx | 4 +- .../versioned_docs/version-2.0.1/search.mdx | 2 +- website/versioned_docs/version-2.0.1/seo.mdx | 2 +- .../version-2.0.1/static-assets.mdx | 2 +- .../version-2.0.1/styling-layout.mdx | 2 +- .../version-2.0.1/swizzling.mdx | 2 +- .../version-2.1.0/advanced/client.mdx | 2 +- .../version-2.1.0/advanced/ssg.mdx | 2 +- .../api/docusaurus.config.js.mdx | 2 +- .../api/misc/create-docusaurus.mdx | 2 +- .../version-2.1.0/api/misc/logger/logger.mdx | 2 +- .../api/plugin-methods/README.mdx | 2 +- .../plugin-methods/extend-infrastructure.mdx | 2 +- .../api/plugin-methods/lifecycle-apis.mdx | 4 +- .../api/plugins/plugin-client-redirects.mdx | 4 +- .../api/plugins/plugin-content-blog.mdx | 2 +- .../api/plugins/plugin-google-analytics.mdx | 2 +- .../api/plugins/plugin-google-gtag.mdx | 2 +- .../version-2.1.0/api/plugins/plugin-pwa.mdx | 4 +- .../api/plugins/plugin-sitemap.mdx | 2 +- .../version-2.1.0/api/themes/overview.mdx | 2 +- .../api/themes/theme-configuration.mdx | 2 +- website/versioned_docs/version-2.1.0/blog.mdx | 4 +- .../version-2.1.0/browser-support.mdx | 2 +- website/versioned_docs/version-2.1.0/cli.mdx | 4 +- .../version-2.1.0/deployment.mdx | 6 +- .../version-2.1.0/docusaurus-core.mdx | 8 +-- .../version-2.1.0/guides/creating-pages.mdx | 2 +- .../guides/docs/docs-introduction.mdx | 2 +- .../guides/docs/docs-multi-instance.mdx | 4 +- .../guides/docs/sidebar/autogenerated.mdx | 2 +- .../guides/docs/sidebar/items.mdx | 2 +- .../version-2.1.0/guides/docs/versioning.mdx | 2 +- .../markdown-features-code-blocks.mdx | 8 +-- .../markdown-features-intro.mdx | 2 +- .../markdown-features-math-equations.mdx | 2 +- .../markdown-features-react.mdx | 6 +- .../markdown-features-toc.mdx | 4 +- .../version-2.1.0/i18n/i18n-crowdin.mdx | 12 ++-- .../version-2.1.0/i18n/i18n-tutorial.mdx | 10 ++-- .../migration/migration-manual.mdx | 2 +- .../migration/migration-translated-sites.mdx | 4 +- .../versioned_docs/version-2.1.0/search.mdx | 2 +- website/versioned_docs/version-2.1.0/seo.mdx | 2 +- .../version-2.1.0/static-assets.mdx | 2 +- .../version-2.1.0/styling-layout.mdx | 2 +- .../version-2.1.0/swizzling.mdx | 2 +- .../version-2.2.0/advanced/client.mdx | 2 +- .../version-2.2.0/advanced/ssg.mdx | 2 +- .../api/docusaurus.config.js.mdx | 2 +- .../api/misc/create-docusaurus.mdx | 2 +- .../version-2.2.0/api/misc/logger/logger.mdx | 2 +- .../api/plugin-methods/README.mdx | 2 +- .../plugin-methods/extend-infrastructure.mdx | 2 +- .../api/plugin-methods/lifecycle-apis.mdx | 4 +- .../api/plugins/plugin-client-redirects.mdx | 4 +- .../api/plugins/plugin-content-blog.mdx | 2 +- .../api/plugins/plugin-google-analytics.mdx | 2 +- .../api/plugins/plugin-google-gtag.mdx | 2 +- .../version-2.2.0/api/plugins/plugin-pwa.mdx | 4 +- .../api/plugins/plugin-sitemap.mdx | 2 +- .../version-2.2.0/api/themes/overview.mdx | 2 +- .../api/themes/theme-configuration.mdx | 2 +- website/versioned_docs/version-2.2.0/blog.mdx | 4 +- .../version-2.2.0/browser-support.mdx | 2 +- website/versioned_docs/version-2.2.0/cli.mdx | 4 +- .../version-2.2.0/deployment.mdx | 6 +- .../version-2.2.0/docusaurus-core.mdx | 8 +-- .../version-2.2.0/guides/creating-pages.mdx | 2 +- .../guides/docs/docs-introduction.mdx | 2 +- .../guides/docs/docs-multi-instance.mdx | 4 +- .../guides/docs/sidebar/autogenerated.mdx | 2 +- .../guides/docs/sidebar/items.mdx | 2 +- .../version-2.2.0/guides/docs/versioning.mdx | 2 +- .../markdown-features-code-blocks.mdx | 8 +-- .../markdown-features-intro.mdx | 2 +- .../markdown-features-math-equations.mdx | 2 +- .../markdown-features-react.mdx | 6 +- .../markdown-features-toc.mdx | 4 +- .../version-2.2.0/i18n/i18n-crowdin.mdx | 12 ++-- .../version-2.2.0/i18n/i18n-tutorial.mdx | 10 ++-- .../migration/migration-manual.mdx | 2 +- .../migration/migration-translated-sites.mdx | 4 +- .../versioned_docs/version-2.2.0/search.mdx | 2 +- website/versioned_docs/version-2.2.0/seo.mdx | 2 +- .../version-2.2.0/static-assets.mdx | 2 +- .../version-2.2.0/styling-layout.mdx | 2 +- .../version-2.2.0/swizzling.mdx | 2 +- .../version-2.3.1/advanced/client.mdx | 2 +- .../version-2.3.1/advanced/ssg.mdx | 2 +- .../api/docusaurus.config.js.mdx | 2 +- .../api/misc/create-docusaurus.mdx | 2 +- .../version-2.3.1/api/misc/logger/logger.mdx | 2 +- .../api/plugin-methods/README.mdx | 2 +- .../plugin-methods/extend-infrastructure.mdx | 2 +- .../api/plugin-methods/lifecycle-apis.mdx | 4 +- .../api/plugins/plugin-client-redirects.mdx | 4 +- .../api/plugins/plugin-content-blog.mdx | 2 +- .../api/plugins/plugin-google-analytics.mdx | 2 +- .../api/plugins/plugin-google-gtag.mdx | 2 +- .../api/plugins/plugin-google-tag-manager.mdx | 2 +- .../version-2.3.1/api/plugins/plugin-pwa.mdx | 4 +- .../api/plugins/plugin-sitemap.mdx | 2 +- .../version-2.3.1/api/themes/overview.mdx | 2 +- .../api/themes/theme-configuration.mdx | 2 +- website/versioned_docs/version-2.3.1/blog.mdx | 4 +- .../version-2.3.1/browser-support.mdx | 2 +- website/versioned_docs/version-2.3.1/cli.mdx | 4 +- .../version-2.3.1/deployment.mdx | 6 +- .../version-2.3.1/docusaurus-core.mdx | 8 +-- .../version-2.3.1/guides/creating-pages.mdx | 2 +- .../guides/docs/docs-introduction.mdx | 2 +- .../guides/docs/docs-multi-instance.mdx | 4 +- .../guides/docs/sidebar/autogenerated.mdx | 2 +- .../guides/docs/sidebar/items.mdx | 2 +- .../version-2.3.1/guides/docs/versioning.mdx | 2 +- .../markdown-features-code-blocks.mdx | 8 +-- .../markdown-features-intro.mdx | 2 +- .../markdown-features-math-equations.mdx | 2 +- .../markdown-features-react.mdx | 6 +- .../markdown-features-toc.mdx | 4 +- .../version-2.3.1/i18n/i18n-crowdin.mdx | 12 ++-- .../version-2.3.1/i18n/i18n-tutorial.mdx | 10 ++-- .../migration/migration-manual.mdx | 2 +- .../migration/migration-translated-sites.mdx | 4 +- .../versioned_docs/version-2.3.1/search.mdx | 2 +- website/versioned_docs/version-2.3.1/seo.mdx | 2 +- .../version-2.3.1/static-assets.mdx | 2 +- .../version-2.3.1/styling-layout.mdx | 2 +- .../version-2.3.1/swizzling.mdx | 2 +- .../version-2.4.1/advanced/client.mdx | 2 +- .../version-2.4.1/advanced/ssg.mdx | 2 +- .../api/docusaurus.config.js.mdx | 2 +- .../api/misc/create-docusaurus.mdx | 2 +- .../version-2.4.1/api/misc/logger/logger.mdx | 2 +- .../api/plugin-methods/README.mdx | 2 +- .../plugin-methods/extend-infrastructure.mdx | 2 +- .../api/plugin-methods/lifecycle-apis.mdx | 4 +- .../api/plugins/plugin-client-redirects.mdx | 4 +- .../api/plugins/plugin-content-blog.mdx | 2 +- .../api/plugins/plugin-google-analytics.mdx | 2 +- .../api/plugins/plugin-google-gtag.mdx | 2 +- .../api/plugins/plugin-google-tag-manager.mdx | 2 +- .../version-2.4.1/api/plugins/plugin-pwa.mdx | 4 +- .../api/plugins/plugin-sitemap.mdx | 2 +- .../version-2.4.1/api/themes/overview.mdx | 2 +- .../api/themes/theme-configuration.mdx | 2 +- website/versioned_docs/version-2.4.1/blog.mdx | 4 +- .../version-2.4.1/browser-support.mdx | 2 +- website/versioned_docs/version-2.4.1/cli.mdx | 4 +- .../version-2.4.1/deployment.mdx | 6 +- .../version-2.4.1/docusaurus-core.mdx | 8 +-- .../version-2.4.1/guides/creating-pages.mdx | 2 +- .../guides/docs/docs-introduction.mdx | 2 +- .../guides/docs/docs-multi-instance.mdx | 4 +- .../guides/docs/sidebar/autogenerated.mdx | 2 +- .../guides/docs/sidebar/items.mdx | 2 +- .../version-2.4.1/guides/docs/versioning.mdx | 2 +- .../markdown-features-code-blocks.mdx | 8 +-- .../markdown-features-intro.mdx | 2 +- .../markdown-features-math-equations.mdx | 2 +- .../markdown-features-react.mdx | 6 +- .../markdown-features-toc.mdx | 4 +- .../version-2.4.1/i18n/i18n-crowdin.mdx | 12 ++-- .../version-2.4.1/i18n/i18n-tutorial.mdx | 10 ++-- .../migration/migration-manual.mdx | 2 +- .../migration/migration-translated-sites.mdx | 4 +- .../versioned_docs/version-2.4.1/search.mdx | 2 +- website/versioned_docs/version-2.4.1/seo.mdx | 2 +- .../version-2.4.1/static-assets.mdx | 2 +- .../version-2.4.1/styling-layout.mdx | 2 +- .../version-2.4.1/swizzling.mdx | 2 +- .../version-3.0.0-alpha.0/advanced/client.mdx | 2 +- .../version-3.0.0-alpha.0/advanced/ssg.mdx | 2 +- .../api/docusaurus.config.js.mdx | 2 +- .../api/misc/create-docusaurus.mdx | 2 +- .../api/misc/logger/logger.mdx | 2 +- .../api/plugin-methods/README.mdx | 2 +- .../plugin-methods/extend-infrastructure.mdx | 2 +- .../api/plugin-methods/lifecycle-apis.mdx | 4 +- .../api/plugins/plugin-client-redirects.mdx | 4 +- .../api/plugins/plugin-content-blog.mdx | 2 +- .../api/plugins/plugin-google-analytics.mdx | 2 +- .../api/plugins/plugin-google-gtag.mdx | 2 +- .../api/plugins/plugin-google-tag-manager.mdx | 2 +- .../api/plugins/plugin-ideal-image.mdx | 2 +- .../api/plugins/plugin-pwa.mdx | 4 +- .../api/plugins/plugin-sitemap.mdx | 2 +- .../api/themes/overview.mdx | 2 +- .../api/themes/theme-configuration.mdx | 2 +- .../version-3.0.0-alpha.0/blog.mdx | 4 +- .../version-3.0.0-alpha.0/browser-support.mdx | 2 +- .../version-3.0.0-alpha.0/cli.mdx | 4 +- .../version-3.0.0-alpha.0/deployment.mdx | 6 +- .../version-3.0.0-alpha.0/docusaurus-core.mdx | 8 +-- .../guides/creating-pages.mdx | 2 +- .../guides/docs/docs-introduction.mdx | 2 +- .../guides/docs/docs-multi-instance.mdx | 4 +- .../guides/docs/sidebar/autogenerated.mdx | 2 +- .../guides/docs/sidebar/items.mdx | 2 +- .../guides/docs/versioning.mdx | 2 +- .../markdown-features-code-blocks.mdx | 8 +-- .../markdown-features-intro.mdx | 2 +- .../markdown-features-math-equations.mdx | 2 +- .../markdown-features-plugins.mdx | 2 +- .../markdown-features-react.mdx | 6 +- .../markdown-features-toc.mdx | 4 +- .../i18n/i18n-crowdin.mdx | 12 ++-- .../i18n/i18n-tutorial.mdx | 10 ++-- .../migration/migration-manual.mdx | 2 +- .../migration/migration-translated-sites.mdx | 4 +- .../version-3.0.0-alpha.0/search.mdx | 2 +- .../version-3.0.0-alpha.0/seo.mdx | 2 +- .../version-3.0.0-alpha.0/static-assets.mdx | 2 +- .../version-3.0.0-alpha.0/styling-layout.mdx | 2 +- .../version-3.0.0-alpha.0/swizzling.mdx | 2 +- 339 files changed, 666 insertions(+), 515 deletions(-) rename packages/docusaurus-theme-classic/src/theme/Admonition/Icon/{Caution.tsx => Warning.tsx} (91%) create mode 100644 packages/docusaurus-theme-classic/src/theme/Admonition/Type/Warning.tsx diff --git a/package.json b/package.json index 2ba6e75b2d..73981fd7c6 100644 --- a/package.json +++ b/package.json @@ -60,7 +60,8 @@ "watch": "yarn lerna run --parallel watch", "clear": "(yarn workspace website clear || echo 'Failure while running docusaurus clear') && yarn rimraf test-website && yarn rimraf test-website-in-workspace && yarn lerna exec --ignore docusaurus yarn rimraf lib", "test:baseUrl": "yarn build:website:baseUrl && yarn serve:website:baseUrl", - "lock:update": "npx --yes yarn-deduplicate" + "lock:update": "npx --yes yarn-deduplicate", + "update-translations": "yarn workspace @docusaurus/theme-translations update" }, "dependencies": { "unified": "^10.1.2" diff --git a/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts b/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts index 4c5ae45d50..f3761d8857 100644 --- a/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts +++ b/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts @@ -19,13 +19,6 @@ export default function getSwizzleConfig(): SwizzleConfig { }, description: 'The folder containing all admonition icons', }, - 'Admonition/Icon/Caution': { - actions: { - eject: 'safe', - wrap: 'safe', - }, - description: 'The admonition caution icon', - }, 'Admonition/Icon/Danger': { actions: { eject: 'safe', @@ -54,6 +47,13 @@ export default function getSwizzleConfig(): SwizzleConfig { }, description: 'The admonition tip icon', }, + 'Admonition/Icon/Warning': { + actions: { + eject: 'safe', + wrap: 'safe', + }, + description: 'The admonition warning icon', + }, 'Admonition/Layout': { actions: { eject: 'safe', @@ -110,6 +110,14 @@ export default function getSwizzleConfig(): SwizzleConfig { description: 'The component responsible for rendering a :::tip admonition type', }, + 'Admonition/Type/Warning': { + actions: { + eject: 'safe', + wrap: 'safe', + }, + description: + 'The component responsible for rendering a :::warning admonition type', + }, 'Admonition/Types': { actions: { eject: 'safe', diff --git a/packages/docusaurus-theme-classic/src/theme-classic.d.ts b/packages/docusaurus-theme-classic/src/theme-classic.d.ts index e1f8987751..77a5cf283c 100644 --- a/packages/docusaurus-theme-classic/src/theme-classic.d.ts +++ b/packages/docusaurus-theme-classic/src/theme-classic.d.ts @@ -74,6 +74,8 @@ declare module '@theme/Admonition/Type/Tip' { export default function AdmonitionTypeTip(props: Props): JSX.Element; } +// TODO remove before v4: Caution replaced by Warning +// see https://github.com/facebook/docusaurus/issues/7558 declare module '@theme/Admonition/Type/Caution' { import type {Props as AdmonitionProps} from '@theme/Admonition'; @@ -81,6 +83,13 @@ declare module '@theme/Admonition/Type/Caution' { export default function AdmonitionTypeCaution(props: Props): JSX.Element; } +declare module '@theme/Admonition/Type/Warning' { + import type {Props as AdmonitionProps} from '@theme/Admonition'; + + export interface Props extends AdmonitionProps {} + export default function AdmonitionTypeWarning(props: Props): JSX.Element; +} + declare module '@theme/Admonition/Type/Danger' { import type {Props as AdmonitionProps} from '@theme/Admonition'; @@ -128,12 +137,12 @@ declare module '@theme/Admonition/Icon/Tip' { export default function AdmonitionIconTip(props: Props): JSX.Element; } -declare module '@theme/Admonition/Icon/Caution' { +declare module '@theme/Admonition/Icon/Warning' { import type {ComponentProps} from 'react'; export interface Props extends ComponentProps<'svg'> {} - export default function AdmonitionIconCaution(props: Props): JSX.Element; + export default function AdmonitionIconWarning(props: Props): JSX.Element; } declare module '@theme/Admonition/Icon/Danger' { diff --git a/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Caution.tsx b/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Warning.tsx similarity index 91% rename from packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Caution.tsx rename to packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Warning.tsx index ae47231d1f..ae56e93a60 100644 --- a/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Caution.tsx +++ b/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Warning.tsx @@ -6,7 +6,7 @@ */ import React from 'react'; -import type {Props} from '@theme/Admonition/Icon/Caution'; +import type {Props} from '@theme/Admonition/Icon/Warning'; export default function AdmonitionIconCaution(props: Props): JSX.Element { return ( diff --git a/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx b/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx index b929f63540..35e6a19e81 100644 --- a/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx +++ b/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx @@ -10,12 +10,12 @@ import clsx from 'clsx'; import Translate from '@docusaurus/Translate'; import type {Props} from '@theme/Admonition/Type/Caution'; import AdmonitionLayout from '@theme/Admonition/Layout'; -import IconCaution from '@theme/Admonition/Icon/Caution'; +import IconWarning from '@theme/Admonition/Icon/Warning'; const infimaClassName = 'alert alert--warning'; const defaultProps = { - icon: , + icon: , title: ( , + title: ( + + warning + + ), +}; + +export default function AdmonitionTypeWarning(props: Props): JSX.Element { + return ( + + {props.children} + + ); +} diff --git a/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx b/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx index ac36bfe20b..654063cf86 100644 --- a/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx +++ b/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx @@ -9,15 +9,16 @@ import React from 'react'; import AdmonitionTypeNote from '@theme/Admonition/Type/Note'; import AdmonitionTypeTip from '@theme/Admonition/Type/Tip'; import AdmonitionTypeInfo from '@theme/Admonition/Type/Info'; -import AdmonitionTypeCaution from '@theme/Admonition/Type/Caution'; +import AdmonitionTypeWarning from '@theme/Admonition/Type/Warning'; import AdmonitionTypeDanger from '@theme/Admonition/Type/Danger'; +import AdmonitionTypeCaution from '@theme/Admonition/Type/Caution'; import type AdmonitionTypes from '@theme/Admonition/Types'; const admonitionTypes: typeof AdmonitionTypes = { note: AdmonitionTypeNote, tip: AdmonitionTypeTip, info: AdmonitionTypeInfo, - caution: AdmonitionTypeCaution, + warning: AdmonitionTypeWarning, danger: AdmonitionTypeDanger, }; @@ -28,8 +29,7 @@ const admonitionAliases: typeof AdmonitionTypes = { secondary: (props) => , important: (props) => , success: (props) => , - // TODO bad legacy mapping, warning is usually yellow, not red... - warning: (props) => , + caution: AdmonitionTypeCaution, }; export default { diff --git a/packages/docusaurus-theme-translations/locales/ar/theme-common.json b/packages/docusaurus-theme-translations/locales/ar/theme-common.json index a31519a79a..2af8e40a5b 100644 --- a/packages/docusaurus-theme-translations/locales/ar/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/ar/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "معلومات", "theme.admonition.note": "ملاحظة", "theme.admonition.tip": "تلميح", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "أرشيف", "theme.blog.archive.title": "أرشيف", "theme.blog.paginator.navAriaLabel": "التنقل في صفحة قائمة المدونة", diff --git a/packages/docusaurus-theme-translations/locales/base/theme-common.json b/packages/docusaurus-theme-translations/locales/base/theme-common.json index cbdb98d59d..705b1c120b 100644 --- a/packages/docusaurus-theme-translations/locales/base/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/base/theme-common.json @@ -12,8 +12,9 @@ "theme.CodeBlock.wordWrapToggle": "Toggle word wrap", "theme.CodeBlock.wordWrapToggle___DESCRIPTION": "The title attribute for toggle word wrapping button of code block lines", "theme.DocSidebarItem.collapseCategoryAriaLabel": "Collapse sidebar category '{label}'", + "theme.DocSidebarItem.collapseCategoryAriaLabel___DESCRIPTION": "The ARIA label to collapse the sidebar category", "theme.DocSidebarItem.expandCategoryAriaLabel": "Expand sidebar category '{label}'", - "theme.DocSidebarItem.toggleCollapsedCategoryAriaLabel___DESCRIPTION": "The ARIA label to toggle the collapsible sidebar category", + "theme.DocSidebarItem.expandCategoryAriaLabel___DESCRIPTION": "The ARIA label to expand the sidebar category", "theme.ErrorPageContent.title": "This page crashed.", "theme.ErrorPageContent.title___DESCRIPTION": "The title of the fallback page when the page crashed", "theme.ErrorPageContent.tryAgain": "Try again", @@ -38,6 +39,8 @@ "theme.admonition.note___DESCRIPTION": "The default label used for the Note admonition (:::note)", "theme.admonition.tip": "tip", "theme.admonition.tip___DESCRIPTION": "The default label used for the Tip admonition (:::tip)", + "theme.admonition.warning": "warning", + "theme.admonition.warning___DESCRIPTION": "The default label used for the Warning admonition (:::warning)", "theme.blog.archive.description": "Archive", "theme.blog.archive.description___DESCRIPTION": "The page & hero description of the blog archive page", "theme.blog.archive.title": "Archive", diff --git a/packages/docusaurus-theme-translations/locales/bn/theme-common.json b/packages/docusaurus-theme-translations/locales/bn/theme-common.json index 8dc7fa7698..05fdee9f79 100644 --- a/packages/docusaurus-theme-translations/locales/bn/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/bn/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "ব্লগ তালিকা পেজ নেভিগেশন", diff --git a/packages/docusaurus-theme-translations/locales/cs/theme-common.json b/packages/docusaurus-theme-translations/locales/cs/theme-common.json index 9753998f7b..aa2bbb1b97 100644 --- a/packages/docusaurus-theme-translations/locales/cs/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/cs/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "Stránkování článků na blogu", diff --git a/packages/docusaurus-theme-translations/locales/da/theme-common.json b/packages/docusaurus-theme-translations/locales/da/theme-common.json index ea9abfac53..1e8e0058ca 100644 --- a/packages/docusaurus-theme-translations/locales/da/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/da/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "Blogoversigt navigation", diff --git a/packages/docusaurus-theme-translations/locales/de/theme-common.json b/packages/docusaurus-theme-translations/locales/de/theme-common.json index ebf4d7afb9..8d2a75fe92 100644 --- a/packages/docusaurus-theme-translations/locales/de/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/de/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archiv", "theme.blog.archive.title": "Archiv", "theme.blog.paginator.navAriaLabel": "Navigation der Blog-Listenseite", diff --git a/packages/docusaurus-theme-translations/locales/es/theme-common.json b/packages/docusaurus-theme-translations/locales/es/theme-common.json index a7fef14bc0..db97f321cc 100644 --- a/packages/docusaurus-theme-translations/locales/es/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/es/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archivo", "theme.blog.archive.title": "Archivo", "theme.blog.paginator.navAriaLabel": "Navegación por la página de la lista de blogs ", diff --git a/packages/docusaurus-theme-translations/locales/fa/theme-common.json b/packages/docusaurus-theme-translations/locales/fa/theme-common.json index bf6b80e775..fa06a69b15 100644 --- a/packages/docusaurus-theme-translations/locales/fa/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/fa/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "آرشیو", "theme.blog.archive.title": "آرشیو", "theme.blog.paginator.navAriaLabel": "کنترل لیست مطالب وبلاگ", diff --git a/packages/docusaurus-theme-translations/locales/fil/theme-common.json b/packages/docusaurus-theme-translations/locales/fil/theme-common.json index 9d8ba250ef..06175cd03e 100644 --- a/packages/docusaurus-theme-translations/locales/fil/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/fil/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "Nabegasyón para sa pahina na listahan ng blog", diff --git a/packages/docusaurus-theme-translations/locales/fr/theme-common.json b/packages/docusaurus-theme-translations/locales/fr/theme-common.json index cfe6a27eeb..0d80e4a7a9 100644 --- a/packages/docusaurus-theme-translations/locales/fr/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/fr/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "remarque", "theme.admonition.tip": "astuce", + "theme.admonition.warning": "attention", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "Pagination de la liste des articles du blog", diff --git a/packages/docusaurus-theme-translations/locales/he/theme-common.json b/packages/docusaurus-theme-translations/locales/he/theme-common.json index 57817242be..00badf2495 100644 --- a/packages/docusaurus-theme-translations/locales/he/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/he/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "רשימת דפי הבלוג", diff --git a/packages/docusaurus-theme-translations/locales/hi/theme-common.json b/packages/docusaurus-theme-translations/locales/hi/theme-common.json index dfd89f31e3..994c34e08d 100644 --- a/packages/docusaurus-theme-translations/locales/hi/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/hi/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "ब्लॉग सूची पेज नेविगेशन", diff --git a/packages/docusaurus-theme-translations/locales/hu/theme-common.json b/packages/docusaurus-theme-translations/locales/hu/theme-common.json index 0cbd699d1d..8252f9db0c 100644 --- a/packages/docusaurus-theme-translations/locales/hu/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/hu/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "információ", "theme.admonition.note": "megjegyzés", "theme.admonition.tip": "tanács", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archívum", "theme.blog.archive.title": "Archívum", "theme.blog.paginator.navAriaLabel": "Bloglista oldalának navigációja", @@ -67,5 +68,7 @@ "theme.navbar.mobileVersionsDropdown.label": "Verziók", "theme.tags.tagsListLabel": "Címkék:", "theme.tags.tagsPageLink": "Összes címke megtekintése", - "theme.tags.tagsPageTitle": "Címkék" + "theme.tags.tagsPageTitle": "Címkék", + "theme.unlistedContent.message": "This page is unlisted. Search engines will not index it, and only users having a direct link can access it.", + "theme.unlistedContent.title": "Unlisted page" } diff --git a/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json b/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json index 93f5dd7ef3..0bf7ebca24 100644 --- a/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json +++ b/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json @@ -24,7 +24,6 @@ "theme.SearchModal.startScreen.removeFavoriteSearchButtonTitle": "Törölje ezt a keresést a kedvencekből", "theme.SearchModal.startScreen.removeRecentSearchButtonTitle": "Törölje ezt a keresést az előzményekből", "theme.SearchModal.startScreen.saveRecentSearchButtonTitle": "Mentsük el ezt a keresést", - "theme.SearchPage.saveRecentSearchButtonTitle": "Mentse ezt a keresést", "theme.SearchPage.algoliaLabel": "Keresés az Algolia segítségével", "theme.SearchPage.documentsFound.plurals": "Egy dokumentum|{count} dokumentumok", "theme.SearchPage.emptyResultsTitle": "Keresés a webhelyen", @@ -32,5 +31,6 @@ "theme.SearchPage.fetchingNewResults": "Új keresési eredmények betöltése...", "theme.SearchPage.inputLabel": "Keresés", "theme.SearchPage.inputPlaceholder": "Adja meg a keresendő kifejezést", - "theme.SearchPage.noResultsText": "Nincs találat a keresésre" + "theme.SearchPage.noResultsText": "Nincs találat a keresésre", + "theme.SearchPage.saveRecentSearchButtonTitle": "Mentse ezt a keresést" } diff --git a/packages/docusaurus-theme-translations/locales/it/theme-common.json b/packages/docusaurus-theme-translations/locales/it/theme-common.json index a889a9872c..a8e22db336 100644 --- a/packages/docusaurus-theme-translations/locales/it/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/it/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "informazioni", "theme.admonition.note": "note", "theme.admonition.tip": "mancia", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archivio", "theme.blog.archive.title": "Archivio", "theme.blog.paginator.navAriaLabel": "Navigazione nella pagina dei post del blog ", diff --git a/packages/docusaurus-theme-translations/locales/ja/theme-common.json b/packages/docusaurus-theme-translations/locales/ja/theme-common.json index ac10dc533e..317c2ee3ee 100644 --- a/packages/docusaurus-theme-translations/locales/ja/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/ja/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "備考", "theme.admonition.note": "注記", "theme.admonition.tip": "ヒント", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "アーカイブ", "theme.blog.archive.title": "アーカイブ", "theme.blog.paginator.navAriaLabel": "ブログ記事一覧のナビゲーション", diff --git a/packages/docusaurus-theme-translations/locales/ko/theme-common.json b/packages/docusaurus-theme-translations/locales/ko/theme-common.json index b5237e0abd..ae6903ba1d 100644 --- a/packages/docusaurus-theme-translations/locales/ko/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/ko/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "정보", "theme.admonition.note": "노트", "theme.admonition.tip": "팁", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "게시물 목록", "theme.blog.archive.title": "게시물 목록", "theme.blog.paginator.navAriaLabel": "블로그 게시물 목록 탐색", diff --git a/packages/docusaurus-theme-translations/locales/nb/theme-common.json b/packages/docusaurus-theme-translations/locales/nb/theme-common.json index 62ab5577c3..57ea71ddca 100644 --- a/packages/docusaurus-theme-translations/locales/nb/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/nb/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "merknad", "theme.admonition.tip": "tips", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Arkiv", "theme.blog.archive.title": "Arkiv", "theme.blog.paginator.navAriaLabel": "Navigering av bloggliste", diff --git a/packages/docusaurus-theme-translations/locales/nl/theme-common.json b/packages/docusaurus-theme-translations/locales/nl/theme-common.json index 76aaed23f2..36c75b00d3 100644 --- a/packages/docusaurus-theme-translations/locales/nl/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/nl/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "notitie", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archief", "theme.blog.archive.title": "Archief", "theme.blog.paginator.navAriaLabel": "Paginanavigatie blog", diff --git a/packages/docusaurus-theme-translations/locales/pl/theme-common.json b/packages/docusaurus-theme-translations/locales/pl/theme-common.json index 48b1148d58..12a5a8929f 100644 --- a/packages/docusaurus-theme-translations/locales/pl/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/pl/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "informacja", "theme.admonition.note": "notatka", "theme.admonition.tip": "wskazówka", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archiwum", "theme.blog.archive.title": "Archiwum", "theme.blog.paginator.navAriaLabel": "Nawigacja na stronie listy wpisów na blogu", diff --git a/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json b/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json index c2b00bd30b..edf86395d9 100644 --- a/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Arquivo", "theme.blog.archive.title": "Arquivo", "theme.blog.paginator.navAriaLabel": "Navegação da página de listagem do blog", diff --git a/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json b/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json index 65f2d5f897..cea4db7fa3 100644 --- a/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Archive", "theme.blog.archive.title": "Archive", "theme.blog.paginator.navAriaLabel": "Navegação da página de listagem do blog", diff --git a/packages/docusaurus-theme-translations/locales/ru/theme-common.json b/packages/docusaurus-theme-translations/locales/ru/theme-common.json index 96aa3b98bb..cdf7d51b20 100644 --- a/packages/docusaurus-theme-translations/locales/ru/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/ru/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "к сведению", "theme.admonition.note": "примечание", "theme.admonition.tip": "подсказка", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Архив", "theme.blog.archive.title": "Архив", "theme.blog.paginator.navAriaLabel": "Навигация по странице списка блогов", diff --git a/packages/docusaurus-theme-translations/locales/sl/theme-common.json b/packages/docusaurus-theme-translations/locales/sl/theme-common.json index e2f5086246..c072cde0ed 100644 --- a/packages/docusaurus-theme-translations/locales/sl/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/sl/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "informacija", "theme.admonition.note": "opomba", "theme.admonition.tip": "namig", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Arhiv", "theme.blog.archive.title": "Arhiv", "theme.blog.paginator.navAriaLabel": "Navigacija kazala po blogu", diff --git a/packages/docusaurus-theme-translations/locales/sr/theme-common.json b/packages/docusaurus-theme-translations/locales/sr/theme-common.json index 8cf01d9427..0f600118cd 100644 --- a/packages/docusaurus-theme-translations/locales/sr/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/sr/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "note", "theme.admonition.tip": "tip", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Архива", "theme.blog.archive.title": "Архива", "theme.blog.paginator.navAriaLabel": "Навигација за странице блога", diff --git a/packages/docusaurus-theme-translations/locales/sv/theme-common.json b/packages/docusaurus-theme-translations/locales/sv/theme-common.json index 8a2fe47044..37075adecd 100644 --- a/packages/docusaurus-theme-translations/locales/sv/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/sv/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "info", "theme.admonition.note": "anteckning", "theme.admonition.tip": "tips", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Arkiv", "theme.blog.archive.title": "Arkiv", "theme.blog.paginator.navAriaLabel": "Navigation av Blogglista", diff --git a/packages/docusaurus-theme-translations/locales/tr/theme-common.json b/packages/docusaurus-theme-translations/locales/tr/theme-common.json index 673869abee..1106d6a3ea 100644 --- a/packages/docusaurus-theme-translations/locales/tr/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/tr/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "bilgi", "theme.admonition.note": "not", "theme.admonition.tip": "ipucu", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Arşiv", "theme.blog.archive.title": "Arşiv", "theme.blog.paginator.navAriaLabel": "Blog gönderi sayfası navigasyonu", diff --git a/packages/docusaurus-theme-translations/locales/uk/theme-common.json b/packages/docusaurus-theme-translations/locales/uk/theme-common.json index f62e5f6a5d..56ae2980ec 100644 --- a/packages/docusaurus-theme-translations/locales/uk/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/uk/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "інформація", "theme.admonition.note": "примітка", "theme.admonition.tip": "порада", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Архів", "theme.blog.archive.title": "Архів", "theme.blog.paginator.navAriaLabel": "Навігація по сторінці списку блогів", diff --git a/packages/docusaurus-theme-translations/locales/vi/theme-common.json b/packages/docusaurus-theme-translations/locales/vi/theme-common.json index 01728da7ae..4ced54b82e 100644 --- a/packages/docusaurus-theme-translations/locales/vi/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/vi/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "thông tin", "theme.admonition.note": "ghi chú", "theme.admonition.tip": "mẹo", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "Lưu trữ", "theme.blog.archive.title": "Lưu trữ", "theme.blog.paginator.navAriaLabel": "Thanh điều hướng của trang danh sách bài viết", diff --git a/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json b/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json index 8faa0785e6..4a1a07f260 100644 --- a/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "信息", "theme.admonition.note": "备注", "theme.admonition.tip": "提示", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "历史博文", "theme.blog.archive.title": "历史博文", "theme.blog.paginator.navAriaLabel": "博文列表分页导航", diff --git a/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json b/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json index bf587d691e..667566b1fc 100644 --- a/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json +++ b/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json @@ -19,6 +19,7 @@ "theme.admonition.info": "信息", "theme.admonition.note": "備註", "theme.admonition.tip": "提示", + "theme.admonition.warning": "warning", "theme.blog.archive.description": "歷史文章", "theme.blog.archive.title": "歷史文章", "theme.blog.paginator.navAriaLabel": "部落格文章列表分頁導覽", diff --git a/website/_dogfooding/_docs tests/tests/admonitions.mdx b/website/_dogfooding/_docs tests/tests/admonitions.mdx index 1ecbb3c9a2..9c41cffec2 100644 --- a/website/_dogfooding/_docs tests/tests/admonitions.mdx +++ b/website/_dogfooding/_docs tests/tests/admonitions.mdx @@ -53,3 +53,63 @@ import InfoIcon from "@theme/Admonition/Icon/Info" content ``` + +## Official admonitions + +Admonitions that are [officially documented](/docs/markdown-features/admonitions) + +:::note + +note + +::: + +:::info + +info + +::: + +:::tip + +tip + +::: + +:::warning + +warning + +::: + +:::danger + +danger + +::: + +## Legacy admonitions + +:::secondary + +secondary + +::: + +:::important + +important + +::: + +:::success + +success + +::: + +:::caution + +caution + +::: diff --git a/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx b/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx index 1b8a41ab51..037a1f9e64 100644 --- a/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx +++ b/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx @@ -271,13 +271,13 @@ Emojis in this text will be replaced with [remark-emoji](https://www.npmjs.com/p ## Admonitions -:::caution Interpolated `title` with a (old syntax) +:::warning Interpolated `title` with a (old syntax) Admonition body ::: -:::caution[Interpolated `title` with a (directive label syntax)] +:::warning[Interpolated `title` with a (directive label syntax)] Admonition body diff --git a/website/blog/releases/2.3/index.mdx b/website/blog/releases/2.3/index.mdx index a570d9cfe0..2ce5005ae4 100644 --- a/website/blog/releases/2.3/index.mdx +++ b/website/blog/releases/2.3/index.mdx @@ -22,7 +22,7 @@ Google Tag Manager is a tag management system that allows great flexibility. It We now have a [`@docusaurus/plugin-google-tag-manager`](/docs/api/plugins/@docusaurus/plugin-google-tag-manager/) package that you can use alongside or as an alternative to the existing [gtag.js plugin](/docs/api/plugins/@docusaurus/plugin-google-gtag/) (refer to [this doc](https://support.google.com/tagmanager/answer/7582054) to understand when to use which solution). -:::caution Google is sunsetting Universal Analytics +:::warning Google is sunsetting Universal Analytics [Google will sunset its Universal Analytics](https://blog.google/products/marketingplatform/analytics/prepare-for-future-with-google-analytics-4/) on **July 1, 2023**, and ask users to migrate to **Google Analytics 4**. diff --git a/website/blog/releases/2.4/index.mdx b/website/blog/releases/2.4/index.mdx index d02dfd3544..7eeea9aabb 100644 --- a/website/blog/releases/2.4/index.mdx +++ b/website/blog/releases/2.4/index.mdx @@ -104,7 +104,7 @@ module.exports = { }; ``` -:::caution Google is sunsetting Universal Analytics +:::warning Google is sunsetting Universal Analytics **[Google will sunset its Universal Analytics](https://blog.google/products/marketingplatform/analytics/prepare-for-future-with-google-analytics-4/)** on **July 1, 2023**. diff --git a/website/community/4-canary.mdx b/website/community/4-canary.mdx index a6f278899f..698dd1f8ac 100644 --- a/website/community/4-canary.mdx +++ b/website/community/4-canary.mdx @@ -32,7 +32,7 @@ A canary release passes all automated tests and is used in production by the Doc ``` -:::caution +:::warning The canary version shown below **may not be up-to-date**. Please go to the [npm page](https://www.npmjs.com/package/@docusaurus/core?activeTab=versions) to find the actual version name. @@ -97,7 +97,7 @@ You can also upgrade the `@docusaurus/*` packages with command line: npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary ``` -:::caution +:::warning Make sure to include all the `@docusaurus/*` packages. diff --git a/website/community/5-release-process.mdx b/website/community/5-release-process.mdx index a7d9d8c68b..8185f7a4d3 100644 --- a/website/community/5-release-process.mdx +++ b/website/community/5-release-process.mdx @@ -121,7 +121,7 @@ The next version passes all our automated tests and is used by the Docusaurus si ::: -:::caution +:::warning Breaking changes can happen on the next version: detailed upgrade instructions are available in the changelog and pull requests. diff --git a/website/docs/advanced/client.mdx b/website/docs/advanced/client.mdx index 88762bd362..dd77268610 100644 --- a/website/docs/advanced/client.mdx +++ b/website/docs/advanced/client.mdx @@ -52,7 +52,7 @@ export default function CodeBlock(props) { Check the code of `@docusaurus/theme-live-codeblock` for details. -:::caution +:::warning Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`. diff --git a/website/docs/advanced/ssg.mdx b/website/docs/advanced/ssg.mdx index 7fd0724ece..07931249bb 100644 --- a/website/docs/advanced/ssg.mdx +++ b/website/docs/advanced/ssg.mdx @@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow You may need to escape from SSR since static HTML can't display anything useful without knowing the client state. -:::caution +:::warning It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements. diff --git a/website/docs/api/docusaurus.config.js.mdx b/website/docs/api/docusaurus.config.js.mdx index d1ca832e63..35ab29326a 100644 --- a/website/docs/api/docusaurus.config.js.mdx +++ b/website/docs/api/docusaurus.config.js.mdx @@ -652,7 +652,7 @@ module.exports = { ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png) -:::caution +:::warning This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL. diff --git a/website/docs/api/misc/create-docusaurus.mdx b/website/docs/api/misc/create-docusaurus.mdx index 587fc51da9..c79540e564 100644 --- a/website/docs/api/misc/create-docusaurus.mdx +++ b/website/docs/api/misc/create-docusaurus.mdx @@ -24,7 +24,7 @@ The `template` argument can be one of the following: The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD. -:::caution +:::warning This command should be preferably used in an interactive shell so all features are available. diff --git a/website/docs/api/misc/logger/logger.mdx b/website/docs/api/misc/logger/logger.mdx index 8ce3f5ac29..4c0b37371e 100644 --- a/website/docs/api/misc/logger/logger.mdx +++ b/website/docs/api/misc/logger/logger.mdx @@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi - `success`: prints a success message. - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity. -:::caution A word on the `error` formatter +:::warning A word on the `error` formatter Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly. diff --git a/website/docs/api/plugin-methods/README.mdx b/website/docs/api/plugin-methods/README.mdx index 970af327d0..77ce21e5f9 100644 --- a/website/docs/api/plugin-methods/README.mdx +++ b/website/docs/api/plugin-methods/README.mdx @@ -1,6 +1,6 @@ # Plugin Method References -:::caution +:::warning This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable. diff --git a/website/docs/api/plugin-methods/extend-infrastructure.mdx b/website/docs/api/plugin-methods/extend-infrastructure.mdx index 1885129b70..3394903769 100644 --- a/website/docs/api/plugin-methods/extend-infrastructure.mdx +++ b/website/docs/api/plugin-methods/extend-infrastructure.mdx @@ -33,7 +33,7 @@ module.exports = function (context, options) { Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object. -:::caution +:::warning The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs. diff --git a/website/docs/api/plugin-methods/lifecycle-apis.mdx b/website/docs/api/plugin-methods/lifecycle-apis.mdx index 07257073f1..130884c6d6 100644 --- a/website/docs/api/plugin-methods/lifecycle-apis.mdx +++ b/website/docs/api/plugin-methods/lifecycle-apis.mdx @@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks. -:::caution +:::warning Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible. @@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) { Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument. -:::caution +:::warning The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`) diff --git a/website/docs/api/plugins/plugin-client-redirects.mdx b/website/docs/api/plugins/plugin-client-redirects.mdx index 8e6bd08173..2f5c29d776 100644 --- a/website/docs/api/plugins/plugin-client-redirects.mdx +++ b/website/docs/api/plugins/plugin-client-redirects.mdx @@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**. This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript. -:::caution production only +:::warning production only This plugin is always inactive in development and **only active in production** because it works on the build output. ::: -:::caution +:::warning It is better to use server-side redirects whenever possible. diff --git a/website/docs/api/plugins/plugin-content-blog.mdx b/website/docs/api/plugins/plugin-content-blog.mdx index b640dcae10..17fbe8c36e 100644 --- a/website/docs/api/plugins/plugin-content-blog.mdx +++ b/website/docs/api/plugins/plugin-content-blog.mdx @@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable'; Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus. -:::caution some features production only +:::warning some features production only The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**. diff --git a/website/docs/api/plugins/plugin-google-analytics.mdx b/website/docs/api/plugins/plugin-google-analytics.mdx index 97b5cc0f3f..555e5bea72 100644 --- a/website/docs/api/plugins/plugin-google-analytics.mdx +++ b/website/docs/api/plugins/plugin-google-analytics.mdx @@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create ::: -:::caution production only +:::warning production only This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics. diff --git a/website/docs/api/plugins/plugin-google-gtag.mdx b/website/docs/api/plugins/plugin-google-gtag.mdx index dc1eeaf7b6..501b6c2f42 100644 --- a/website/docs/api/plugins/plugin-google-gtag.mdx +++ b/website/docs/api/plugins/plugin-google-gtag.mdx @@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c ::: -:::caution production only +:::warning production only This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics. diff --git a/website/docs/api/plugins/plugin-google-tag-manager.mdx b/website/docs/api/plugins/plugin-google-tag-manager.mdx index 6e3830a46d..43182aec07 100644 --- a/website/docs/api/plugins/plugin-google-tag-manager.mdx +++ b/website/docs/api/plugins/plugin-google-tag-manager.mdx @@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c ::: -:::caution production only +:::warning production only This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics. diff --git a/website/docs/api/plugins/plugin-ideal-image.mdx b/website/docs/api/plugins/plugin-ideal-image.mdx index 53564895d8..5613f4b981 100644 --- a/website/docs/api/plugins/plugin-ideal-image.mdx +++ b/website/docs/api/plugins/plugin-ideal-image.mdx @@ -36,7 +36,7 @@ import thumbnail from './path/to/img.png'; ``` -:::caution +:::warning This plugin registers a [Webpack loader](https://webpack.js.org/loaders/) that changes the type of imported/require images: diff --git a/website/docs/api/plugins/plugin-pwa.mdx b/website/docs/api/plugins/plugin-pwa.mdx index 2f2c8351b8..6f12d94022 100644 --- a/website/docs/api/plugins/plugin-pwa.mdx +++ b/website/docs/api/plugins/plugin-pwa.mdx @@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content. -:::caution +:::warning Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites. @@ -124,7 +124,7 @@ Strategies used to turn the offline mode on: - `saveData`: activates for users with `navigator.connection.saveData === true` - `always`: activates for all users -:::caution +:::warning Use this carefully: some users may not like to be forced to use the offline mode. diff --git a/website/docs/api/plugins/plugin-sitemap.mdx b/website/docs/api/plugins/plugin-sitemap.mdx index 8bf823bc42..0d6b72763c 100644 --- a/website/docs/api/plugins/plugin-sitemap.mdx +++ b/website/docs/api/plugins/plugin-sitemap.mdx @@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable'; This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately. -:::caution production only +:::warning production only This plugin is always inactive in development and **only active in production** because it works on the build output. diff --git a/website/docs/api/themes/overview.mdx b/website/docs/api/themes/overview.mdx index 4bb78e7ff0..98084d7418 100644 --- a/website/docs/api/themes/overview.mdx +++ b/website/docs/api/themes/overview.mdx @@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co - [@docusaurus/theme-classic](./theme-classic.mdx) - 🚧 other themes are planned -:::caution +:::warning The goal is to have all themes share the exact same features, user-experience and configuration. diff --git a/website/docs/api/themes/theme-configuration.mdx b/website/docs/api/themes/theme-configuration.mdx index 8fb5fe4a44..1ca38a6a35 100644 --- a/website/docs/api/themes/theme-configuration.mdx +++ b/website/docs/api/themes/theme-configuration.mdx @@ -51,7 +51,7 @@ module.exports = { }; ``` -:::caution +:::warning With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences. diff --git a/website/docs/blog.mdx b/website/docs/blog.mdx index 3bd2e65875..0e13e66f3f 100644 --- a/website/docs/blog.mdx +++ b/website/docs/blog.mdx @@ -374,7 +374,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect. -:::caution Feed generation +:::warning Feed generation [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed. @@ -619,7 +619,7 @@ module.exports = { }; ``` -:::caution +:::warning Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route! diff --git a/website/docs/browser-support.mdx b/website/docs/browser-support.mdx index 404601d8f4..79c01861d7 100644 --- a/website/docs/browser-support.mdx +++ b/website/docs/browser-support.mdx @@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th The browser list by default is provided through the `package.json` file as a root `browserslist` field. -:::caution +:::warning On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS. diff --git a/website/docs/cli.mdx b/website/docs/cli.mdx index de6e4babb6..0b38c01776 100644 --- a/website/docs/cli.mdx +++ b/website/docs/cli.mdx @@ -46,7 +46,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). | | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. | -:::important +:::info Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production. @@ -125,7 +125,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro | `--typescript` | Swizzle the TypeScript variant component | | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` | -:::caution +:::warning Unsafe components have a higher risk of breaking changes due to internal refactorings. diff --git a/website/docs/deployment.mdx b/website/docs/deployment.mdx index 4e1945895a..18a7e71e91 100644 --- a/website/docs/deployment.mdx +++ b/website/docs/deployment.mdx @@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`. -:::caution +:::warning Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites): @@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params: These fields also have their environment variable counterparts which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`. -:::caution +:::warning GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`). @@ -336,7 +336,7 @@ cmd /C 'set "GIT_USER=" && yarn deploy' ``` -:::caution +:::warning Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information. diff --git a/website/docs/docusaurus-core.mdx b/website/docs/docusaurus-core.mdx index 7e6615d884..40fcb7cd9f 100644 --- a/website/docs/docusaurus-core.mdx +++ b/website/docs/docusaurus-core.mdx @@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client- - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout. -:::caution +:::warning The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback. @@ -411,7 +411,7 @@ The `siteConfig` object only contains **serializable values** (values that are p Returns `true` when the React app has successfully hydrated in the browser. -:::caution +:::warning Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic. @@ -437,7 +437,7 @@ const MyComponent = () => { React hook to prepend your site `baseUrl` to a string. -:::caution +:::warning **Don't use it for regular links!** @@ -697,7 +697,7 @@ export default function Home() { A module that exposes a few boolean variables to check the current rendering environment. -:::caution +:::warning For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [``](#browseronly) instead. diff --git a/website/docs/guides/creating-pages.mdx b/website/docs/guides/creating-pages.mdx index 30ffdb9faf..ce32424a25 100644 --- a/website/docs/guides/creating-pages.mdx +++ b/website/docs/guides/creating-pages.mdx @@ -129,7 +129,7 @@ my-website . ``` -:::caution +:::warning All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages). diff --git a/website/docs/guides/docs/docs-introduction.mdx b/website/docs/guides/docs/docs-introduction.mdx index 42b756a9f0..fc24f14c7e 100644 --- a/website/docs/guides/docs/docs-introduction.mdx +++ b/website/docs/guides/docs/docs-introduction.mdx @@ -99,7 +99,7 @@ slug: / This page will be the home page when users visit https://example.com/. ``` -:::caution +:::warning If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route! diff --git a/website/docs/guides/docs/docs-multi-instance.mdx b/website/docs/guides/docs/docs-multi-instance.mdx index c1acd0195b..d9934e3bce 100644 --- a/website/docs/guides/docs/docs-multi-instance.mdx +++ b/website/docs/guides/docs/docs-multi-instance.mdx @@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations: In this case, you can use a distinct docs plugin instance per mobile SDK documentation. -:::caution +:::warning If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites. @@ -55,7 +55,7 @@ Suppose you have 2 documentations: In this case, you should use the same plugin twice in your site configuration. -:::caution +:::warning `@docusaurus/preset-classic` already includes a docs plugin instance for you! diff --git a/website/docs/guides/docs/sidebar/autogenerated.mdx b/website/docs/guides/docs/sidebar/autogenerated.mdx index edaa670c6d..b812da5e33 100644 --- a/website/docs/guides/docs/sidebar/autogenerated.mdx +++ b/website/docs/guides/docs/sidebar/autogenerated.mdx @@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths. -:::caution +:::warning **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**. diff --git a/website/docs/guides/docs/sidebar/items.mdx b/website/docs/guides/docs/sidebar/items.mdx index 1e358a12fe..77789ebf47 100644 --- a/website/docs/guides/docs/sidebar/items.mdx +++ b/website/docs/guides/docs/sidebar/items.mdx @@ -400,7 +400,7 @@ module.exports = { }; ``` -:::caution +:::warning When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded. diff --git a/website/docs/guides/docs/versioning.mdx b/website/docs/guides/docs/versioning.mdx index df27a964f0..2b5657f48d 100644 --- a/website/docs/guides/docs/versioning.mdx +++ b/website/docs/guides/docs/versioning.mdx @@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; ``` -:::caution +:::warning Think about it before starting to version your documentation - it can become difficult for contributors to help improve it! diff --git a/website/docs/guides/markdown-features/markdown-features-admonitions.mdx b/website/docs/guides/markdown-features/markdown-features-admonitions.mdx index d1ae159315..dde6799aab 100644 --- a/website/docs/guides/markdown-features/markdown-features-admonitions.mdx +++ b/website/docs/guides/markdown-features/markdown-features-admonitions.mdx @@ -34,7 +34,7 @@ Some **content** with _Markdown_ `syntax`. Check [this `api`](#). ::: -:::caution +:::warning Some **content** with _Markdown_ `syntax`. Check [this `api`](#). @@ -68,7 +68,7 @@ Some **content** with _Markdown_ `syntax`. Check [this `api`](#). ::: -:::caution +:::warning Some **content** with _Markdown_ `syntax`. Check [this `api`](#). @@ -231,7 +231,7 @@ export default function MyReactPage() { } ``` -The types that are accepted are the same as above: `note`, `tip`, `danger`, `info`, `caution`. Optionally, you can specify an icon by passing a JSX element or a string, or a title: +The types that are accepted are the same as above: `note`, `tip`, `danger`, `info`, `warning`. Optionally, you can specify an icon by passing a JSX element or a string, or a title: ```jsx title="MyReactPage.jsx" @@ -282,7 +282,7 @@ module.exports = { { docs: { admonitions: { - keywords: ['note', 'tip', 'info', 'caution', 'danger'], + keywords: ['note', 'tip', 'info', 'warning', 'danger'], extendDefaults: true, }, }, diff --git a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx index 6f87578892..e2f1dab444 100644 --- a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx +++ b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx @@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23). -:::caution +:::warning Some popular languages like Java, C#, or PHP are not enabled by default. @@ -512,7 +512,7 @@ function Clock(props) { ### Imports {#imports} -:::caution react-live and imports +:::warning react-live and imports It is not possible to import components directly from the react-live code editor, you have to define available imports upfront. @@ -644,13 +644,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use -:::caution MDX is whitespace insensitive +:::warning MDX is whitespace insensitive MDX is in line with JSX behavior: line break characters, even when inside `
`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
index 1b1a8ad38d..74aa4349e5 100644
--- a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@5 rehype-katex@6
 ```
 
-:::caution
+:::warning
 
 Make sure to use `remark-math >= 5` and `rehype-katex >= 6` for Docusaurus v3 (using MDX v2).
 
diff --git a/website/docs/guides/markdown-features/markdown-features-plugins.mdx b/website/docs/guides/markdown-features/markdown-features-plugins.mdx
index 1db6a6a67e..00c45da6b1 100644
--- a/website/docs/guides/markdown-features/markdown-features-plugins.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-plugins.mdx
@@ -57,7 +57,7 @@ Next, the `rehype-katex` operates on the Hypertext AST where everything has been
 
 
 
-:::caution
+:::warning
 
 Many official Remark/Rehype plugins are using ES Modules, a new JavaScript module system, which Docusaurus doesn't support yet. To work around this issue, we recommend to use dynamic `import()` inside an `async` config creation function.
 
diff --git a/website/docs/guides/markdown-features/markdown-features-react.mdx b/website/docs/guides/markdown-features/markdown-features-react.mdx
index a8ca44af65..7722a6e5c5 100644
--- a/website/docs/guides/markdown-features/markdown-features-react.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -198,7 +198,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [an `MDXProvider`](https://mdxjs.com/docs/using-mdx/#mdx-provider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -319,7 +319,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/docs/guides/markdown-features/markdown-features-toc.mdx b/website/docs/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f25..bfc161c542 100644
--- a/website/docs/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/docs/i18n/i18n-crowdin.mdx b/website/docs/i18n/i18n-crowdin.mdx
index b57dbb71e0..b10c9246d8 100644
--- a/website/docs/i18n/i18n-crowdin.mdx
+++ b/website/docs/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -394,7 +394,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -443,7 +443,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/docs/i18n/i18n-tutorial.mdx b/website/docs/i18n/i18n-tutorial.mdx
index 7e9de4cbb7..45057041fc 100644
--- a/website/docs/i18n/i18n-tutorial.mdx
+++ b/website/docs/i18n/i18n-tutorial.mdx
@@ -96,7 +96,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -123,7 +123,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`
-:::caution MDX is whitespace insensitive +:::warning MDX is whitespace insensitive MDX is in line with JSX behavior: line break characters, even when inside `
`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx
index 30212e5004..643f621c5b 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5..cb218c280c 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx
index da8e9fd86b..ba8b213e38 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f25..bfc161c542 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx
index bd0306091f..011b332d4a 100644
--- a/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx
index 1cdd4e6e4b..de7c22845a 100644
--- a/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`Download this document
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `` / ``, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.0.1/styling-layout.mdx b/website/versioned_docs/version-2.0.1/styling-layout.mdx
index d11c8ab074..289aafa205 100644
--- a/website/versioned_docs/version-2.0.1/styling-layout.mdx
+++ b/website/versioned_docs/version-2.0.1/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.0.1/swizzling.mdx b/website/versioned_docs/version-2.0.1/swizzling.mdx
index dcddfbe078..21ef6eb1d0 100644
--- a/website/versioned_docs/version-2.0.1/swizzling.mdx
+++ b/website/versioned_docs/version-2.0.1/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.1.0/advanced/client.mdx b/website/versioned_docs/version-2.1.0/advanced/client.mdx
index 189faab8ba..6a01e76346 100644
--- a/website/versioned_docs/version-2.1.0/advanced/client.mdx
+++ b/website/versioned_docs/version-2.1.0/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.1.0/advanced/ssg.mdx b/website/versioned_docs/version-2.1.0/advanced/ssg.mdx
index 7fd0724ece..07931249bb 100644
--- a/website/versioned_docs/version-2.1.0/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.1.0/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx
index a6c5215fc2..7b8c86edc7 100644
--- a/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx
@@ -565,7 +565,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx
index b4dc0491e4..039145e1df 100644
--- a/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx
index 04800ed25b..18ecf3ef07 100644
--- a/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx
index 970af327d0..77ce21e5f9 100644
--- a/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx
index 1885129b70..3394903769 100644
--- a/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b..4d0dad6521 100644
--- a/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173..2f5c29d776 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx
index b20a58284b..72179a2c00 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx
index b3b77732b4..33a5d2bf79 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 The default [Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) plugin. It is a JavaScript library for measuring how users interact with your website **in the production build**. If you are using Google Analytics 4 you might need to consider using [plugin-google-gtag](./plugin-google-gtag.mdx) instead.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx
index fca251edd3..7eb16e0dd1 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx
index b6c2b287e1..2f96eddffa 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx
index 8bf823bc42..0d6b72763c 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.1.0/api/themes/overview.mdx b/website/versioned_docs/version-2.1.0/api/themes/overview.mdx
index 4bb78e7ff0..98084d7418 100644
--- a/website/versioned_docs/version-2.1.0/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.1.0/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx
index 90259d7781..2247d54172 100644
--- a/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.1.0/blog.mdx b/website/versioned_docs/version-2.1.0/blog.mdx
index 66d728ddf9..ace263ad73 100644
--- a/website/versioned_docs/version-2.1.0/blog.mdx
+++ b/website/versioned_docs/version-2.1.0/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -590,7 +590,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.1.0/browser-support.mdx b/website/versioned_docs/version-2.1.0/browser-support.mdx
index 404601d8f4..79c01861d7 100644
--- a/website/versioned_docs/version-2.1.0/browser-support.mdx
+++ b/website/versioned_docs/version-2.1.0/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.1.0/cli.mdx b/website/versioned_docs/version-2.1.0/cli.mdx
index 2f57a03ba0..1923f1cc97 100644
--- a/website/versioned_docs/version-2.1.0/cli.mdx
+++ b/website/versioned_docs/version-2.1.0/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -123,7 +123,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--danger`      | Allow immediate swizzling of unsafe components        |
 | `--typescript`  | Swizzle the TypeScript variant component              |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.1.0/deployment.mdx b/website/versioned_docs/version-2.1.0/deployment.mdx
index 3a20f0b64b..f1007b91e7 100644
--- a/website/versioned_docs/version-2.1.0/deployment.mdx
+++ b/website/versioned_docs/version-2.1.0/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=" && yarn deploy'
 
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.1.0/docusaurus-core.mdx b/website/versioned_docs/version-2.1.0/docusaurus-core.mdx
index 409a6082c9..12ba618d86 100644
--- a/website/versioned_docs/version-2.1.0/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.1.0/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [``](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx b/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx
index 30ffdb9faf..ce32424a25 100644
--- a/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx
index 250342e26b..6e27e6be77 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx
index c1acd0195b..d9934e3bce 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx
index c489689dc6..4ac6fa6e62 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx
index b2793826f9..52f62b8301 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx
@@ -398,7 +398,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx b/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx
index df27a964f0..2b5657f48d 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx
index 1871536619..cccf4f45e3 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
-:::caution MDX is whitespace insensitive +:::warning MDX is whitespace insensitive MDX is in line with JSX behavior: line break characters, even when inside `
`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx
index 30212e5004..643f621c5b 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5..cb218c280c 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx
index da8e9fd86b..ba8b213e38 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f25..bfc161c542 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx
index bd0306091f..011b332d4a 100644
--- a/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx
index 1cdd4e6e4b..de7c22845a 100644
--- a/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`Download this document
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `` / ``, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.1.0/styling-layout.mdx b/website/versioned_docs/version-2.1.0/styling-layout.mdx
index d11c8ab074..289aafa205 100644
--- a/website/versioned_docs/version-2.1.0/styling-layout.mdx
+++ b/website/versioned_docs/version-2.1.0/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.1.0/swizzling.mdx b/website/versioned_docs/version-2.1.0/swizzling.mdx
index dcddfbe078..21ef6eb1d0 100644
--- a/website/versioned_docs/version-2.1.0/swizzling.mdx
+++ b/website/versioned_docs/version-2.1.0/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.2.0/advanced/client.mdx b/website/versioned_docs/version-2.2.0/advanced/client.mdx
index 189faab8ba..6a01e76346 100644
--- a/website/versioned_docs/version-2.2.0/advanced/client.mdx
+++ b/website/versioned_docs/version-2.2.0/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.2.0/advanced/ssg.mdx b/website/versioned_docs/version-2.2.0/advanced/ssg.mdx
index 7fd0724ece..07931249bb 100644
--- a/website/versioned_docs/version-2.2.0/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.2.0/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx
index 0601b2e39e..33e5cd6c6f 100644
--- a/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx
@@ -589,7 +589,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx
index b4dc0491e4..039145e1df 100644
--- a/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx
index 04800ed25b..18ecf3ef07 100644
--- a/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx
index 970af327d0..77ce21e5f9 100644
--- a/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx
index 1885129b70..3394903769 100644
--- a/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b..4d0dad6521 100644
--- a/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173..2f5c29d776 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx
index b20a58284b..72179a2c00 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx
index b3b77732b4..33a5d2bf79 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 The default [Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) plugin. It is a JavaScript library for measuring how users interact with your website **in the production build**. If you are using Google Analytics 4 you might need to consider using [plugin-google-gtag](./plugin-google-gtag.mdx) instead.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx
index fca251edd3..7eb16e0dd1 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx
index b6c2b287e1..2f96eddffa 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx
index 8bf823bc42..0d6b72763c 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.2.0/api/themes/overview.mdx b/website/versioned_docs/version-2.2.0/api/themes/overview.mdx
index 4bb78e7ff0..98084d7418 100644
--- a/website/versioned_docs/version-2.2.0/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.2.0/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx
index 90259d7781..2247d54172 100644
--- a/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.2.0/blog.mdx b/website/versioned_docs/version-2.2.0/blog.mdx
index 66d728ddf9..ace263ad73 100644
--- a/website/versioned_docs/version-2.2.0/blog.mdx
+++ b/website/versioned_docs/version-2.2.0/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -590,7 +590,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.2.0/browser-support.mdx b/website/versioned_docs/version-2.2.0/browser-support.mdx
index 404601d8f4..79c01861d7 100644
--- a/website/versioned_docs/version-2.2.0/browser-support.mdx
+++ b/website/versioned_docs/version-2.2.0/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.2.0/cli.mdx b/website/versioned_docs/version-2.2.0/cli.mdx
index 02321c3889..aaa652a48d 100644
--- a/website/versioned_docs/version-2.2.0/cli.mdx
+++ b/website/versioned_docs/version-2.2.0/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -124,7 +124,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.2.0/deployment.mdx b/website/versioned_docs/version-2.2.0/deployment.mdx
index 3a20f0b64b..f1007b91e7 100644
--- a/website/versioned_docs/version-2.2.0/deployment.mdx
+++ b/website/versioned_docs/version-2.2.0/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=" && yarn deploy'
 
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.2.0/docusaurus-core.mdx b/website/versioned_docs/version-2.2.0/docusaurus-core.mdx
index 409a6082c9..12ba618d86 100644
--- a/website/versioned_docs/version-2.2.0/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.2.0/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [``](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx b/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx
index 30ffdb9faf..ce32424a25 100644
--- a/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx
index 250342e26b..6e27e6be77 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx
index c1acd0195b..d9934e3bce 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx
index c489689dc6..4ac6fa6e62 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx
index b2793826f9..52f62b8301 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx
@@ -398,7 +398,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx b/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx
index df27a964f0..2b5657f48d 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx
index 1871536619..cccf4f45e3 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
-:::caution MDX is whitespace insensitive +:::warning MDX is whitespace insensitive MDX is in line with JSX behavior: line break characters, even when inside `
`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx
index 30212e5004..643f621c5b 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5..cb218c280c 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx
index 898208953d..df7b70fc9f 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f25..bfc161c542 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx
index bd0306091f..011b332d4a 100644
--- a/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx
index 1cdd4e6e4b..de7c22845a 100644
--- a/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`Download this document
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `` / ``, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.2.0/styling-layout.mdx b/website/versioned_docs/version-2.2.0/styling-layout.mdx
index d11c8ab074..289aafa205 100644
--- a/website/versioned_docs/version-2.2.0/styling-layout.mdx
+++ b/website/versioned_docs/version-2.2.0/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.2.0/swizzling.mdx b/website/versioned_docs/version-2.2.0/swizzling.mdx
index dcddfbe078..21ef6eb1d0 100644
--- a/website/versioned_docs/version-2.2.0/swizzling.mdx
+++ b/website/versioned_docs/version-2.2.0/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.3.1/advanced/client.mdx b/website/versioned_docs/version-2.3.1/advanced/client.mdx
index 189faab8ba..6a01e76346 100644
--- a/website/versioned_docs/version-2.3.1/advanced/client.mdx
+++ b/website/versioned_docs/version-2.3.1/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.3.1/advanced/ssg.mdx b/website/versioned_docs/version-2.3.1/advanced/ssg.mdx
index 7fd0724ece..07931249bb 100644
--- a/website/versioned_docs/version-2.3.1/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.3.1/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx
index 0601b2e39e..33e5cd6c6f 100644
--- a/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx
@@ -589,7 +589,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx
index b4dc0491e4..039145e1df 100644
--- a/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx
index 04800ed25b..18ecf3ef07 100644
--- a/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx
index 970af327d0..77ce21e5f9 100644
--- a/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx
index 1885129b70..3394903769 100644
--- a/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b..4d0dad6521 100644
--- a/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173..2f5c29d776 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx
index e6ffc4d9b0..8afee91793 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx
index 97b5cc0f3f..555e5bea72 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx
@@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx
index fca251edd3..7eb16e0dd1 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx
index bfc9d4130a..e1b1589db6 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx
index b6c2b287e1..2f96eddffa 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx
index 8bf823bc42..0d6b72763c 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.3.1/api/themes/overview.mdx b/website/versioned_docs/version-2.3.1/api/themes/overview.mdx
index 4bb78e7ff0..98084d7418 100644
--- a/website/versioned_docs/version-2.3.1/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.3.1/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx
index 90259d7781..2247d54172 100644
--- a/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.3.1/blog.mdx b/website/versioned_docs/version-2.3.1/blog.mdx
index cb3110859a..82b89e30b2 100644
--- a/website/versioned_docs/version-2.3.1/blog.mdx
+++ b/website/versioned_docs/version-2.3.1/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -609,7 +609,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.3.1/browser-support.mdx b/website/versioned_docs/version-2.3.1/browser-support.mdx
index 404601d8f4..79c01861d7 100644
--- a/website/versioned_docs/version-2.3.1/browser-support.mdx
+++ b/website/versioned_docs/version-2.3.1/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.3.1/cli.mdx b/website/versioned_docs/version-2.3.1/cli.mdx
index 02321c3889..aaa652a48d 100644
--- a/website/versioned_docs/version-2.3.1/cli.mdx
+++ b/website/versioned_docs/version-2.3.1/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -124,7 +124,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.3.1/deployment.mdx b/website/versioned_docs/version-2.3.1/deployment.mdx
index 3a20f0b64b..f1007b91e7 100644
--- a/website/versioned_docs/version-2.3.1/deployment.mdx
+++ b/website/versioned_docs/version-2.3.1/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=" && yarn deploy'
 
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.3.1/docusaurus-core.mdx b/website/versioned_docs/version-2.3.1/docusaurus-core.mdx
index 409a6082c9..12ba618d86 100644
--- a/website/versioned_docs/version-2.3.1/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.3.1/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [``](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx b/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx
index 30ffdb9faf..ce32424a25 100644
--- a/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx
index 250342e26b..6e27e6be77 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx
index c1acd0195b..d9934e3bce 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx
index c489689dc6..4ac6fa6e62 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx
index b2793826f9..52f62b8301 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx
@@ -398,7 +398,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx b/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx
index df27a964f0..2b5657f48d 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx
index 1871536619..cccf4f45e3 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
-:::caution MDX is whitespace insensitive +:::warning MDX is whitespace insensitive MDX is in line with JSX behavior: line break characters, even when inside `
`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx
index 30212e5004..643f621c5b 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5..cb218c280c 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx
index 431377b98b..ac2c4a2ebc 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f25..bfc161c542 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx
index bd0306091f..011b332d4a 100644
--- a/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx
index 1cdd4e6e4b..de7c22845a 100644
--- a/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`Download this document
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `` / ``, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.3.1/styling-layout.mdx b/website/versioned_docs/version-2.3.1/styling-layout.mdx
index d11c8ab074..289aafa205 100644
--- a/website/versioned_docs/version-2.3.1/styling-layout.mdx
+++ b/website/versioned_docs/version-2.3.1/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.3.1/swizzling.mdx b/website/versioned_docs/version-2.3.1/swizzling.mdx
index dcddfbe078..21ef6eb1d0 100644
--- a/website/versioned_docs/version-2.3.1/swizzling.mdx
+++ b/website/versioned_docs/version-2.3.1/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.4.1/advanced/client.mdx b/website/versioned_docs/version-2.4.1/advanced/client.mdx
index 189faab8ba..6a01e76346 100644
--- a/website/versioned_docs/version-2.4.1/advanced/client.mdx
+++ b/website/versioned_docs/version-2.4.1/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.4.1/advanced/ssg.mdx b/website/versioned_docs/version-2.4.1/advanced/ssg.mdx
index 7fd0724ece..07931249bb 100644
--- a/website/versioned_docs/version-2.4.1/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.4.1/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx
index 052baa5b06..b89c84a3c5 100644
--- a/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx
@@ -589,7 +589,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx
index b4dc0491e4..039145e1df 100644
--- a/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx
index 04800ed25b..18ecf3ef07 100644
--- a/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx
index 970af327d0..77ce21e5f9 100644
--- a/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx
index 1885129b70..3394903769 100644
--- a/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b..4d0dad6521 100644
--- a/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173..2f5c29d776 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx
index e6ffc4d9b0..8afee91793 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx
index 97b5cc0f3f..555e5bea72 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx
@@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx
index dc1eeaf7b6..501b6c2f42 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx
index bfc9d4130a..e1b1589db6 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx
index b6c2b287e1..2f96eddffa 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx
index 8bf823bc42..0d6b72763c 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.4.1/api/themes/overview.mdx b/website/versioned_docs/version-2.4.1/api/themes/overview.mdx
index 4bb78e7ff0..98084d7418 100644
--- a/website/versioned_docs/version-2.4.1/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.4.1/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx
index 90259d7781..2247d54172 100644
--- a/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.4.1/blog.mdx b/website/versioned_docs/version-2.4.1/blog.mdx
index cb3110859a..82b89e30b2 100644
--- a/website/versioned_docs/version-2.4.1/blog.mdx
+++ b/website/versioned_docs/version-2.4.1/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -609,7 +609,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.4.1/browser-support.mdx b/website/versioned_docs/version-2.4.1/browser-support.mdx
index 404601d8f4..79c01861d7 100644
--- a/website/versioned_docs/version-2.4.1/browser-support.mdx
+++ b/website/versioned_docs/version-2.4.1/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.4.1/cli.mdx b/website/versioned_docs/version-2.4.1/cli.mdx
index 02321c3889..aaa652a48d 100644
--- a/website/versioned_docs/version-2.4.1/cli.mdx
+++ b/website/versioned_docs/version-2.4.1/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -124,7 +124,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.4.1/deployment.mdx b/website/versioned_docs/version-2.4.1/deployment.mdx
index 3a20f0b64b..f1007b91e7 100644
--- a/website/versioned_docs/version-2.4.1/deployment.mdx
+++ b/website/versioned_docs/version-2.4.1/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=" && yarn deploy'
 
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.4.1/docusaurus-core.mdx b/website/versioned_docs/version-2.4.1/docusaurus-core.mdx
index 409a6082c9..12ba618d86 100644
--- a/website/versioned_docs/version-2.4.1/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.4.1/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [``](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx b/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx
index 30ffdb9faf..ce32424a25 100644
--- a/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx
index 250342e26b..6e27e6be77 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx
index c1acd0195b..d9934e3bce 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx
index c489689dc6..4ac6fa6e62 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx
index 1e358a12fe..77789ebf47 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx
@@ -400,7 +400,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx b/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx
index df27a964f0..2b5657f48d 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx
index be4ac0b6a8..9214382c59 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
-:::caution MDX is whitespace insensitive +:::warning MDX is whitespace insensitive MDX is in line with JSX behavior: line break characters, even when inside `
`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx
index 30212e5004..643f621c5b 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5..cb218c280c 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx
index 431377b98b..ac2c4a2ebc 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f25..bfc161c542 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx
index bd0306091f..011b332d4a 100644
--- a/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx
index 1cdd4e6e4b..de7c22845a 100644
--- a/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`Download this document
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `` / ``, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.4.1/styling-layout.mdx b/website/versioned_docs/version-2.4.1/styling-layout.mdx
index cac5c8ca86..27c00672a6 100644
--- a/website/versioned_docs/version-2.4.1/styling-layout.mdx
+++ b/website/versioned_docs/version-2.4.1/styling-layout.mdx
@@ -189,7 +189,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.4.1/swizzling.mdx b/website/versioned_docs/version-2.4.1/swizzling.mdx
index dcddfbe078..21ef6eb1d0 100644
--- a/website/versioned_docs/version-2.4.1/swizzling.mdx
+++ b/website/versioned_docs/version-2.4.1/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx b/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx
index 189faab8ba..6a01e76346 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx b/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx
index 7fd0724ece..07931249bb 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx
index 80ca18d069..9259b0e185 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx
@@ -612,7 +612,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx
index b4dc0491e4..039145e1df 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx
index 04800ed25b..18ecf3ef07 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx
index 970af327d0..77ce21e5f9 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx
index 1885129b70..3394903769 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx
index 07257073f1..130884c6d6 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173..2f5c29d776 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx
index 52212f8b56..54adf6d725 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx
index 97b5cc0f3f..555e5bea72 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx
@@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx
index dc1eeaf7b6..501b6c2f42 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx
index 6e3830a46d..43182aec07 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx
index 53564895d8..5613f4b981 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx
@@ -36,7 +36,7 @@ import thumbnail from './path/to/img.png';
 
 ```
 
-:::caution
+:::warning
 
 This plugin registers a [Webpack loader](https://webpack.js.org/loaders/) that changes the type of imported/require images:
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx
index 2f2c8351b8..6f12d94022 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx
index 8bf823bc42..0d6b72763c 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx
index 4bb78e7ff0..98084d7418 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx
index 76801a7b8b..1c41523e4a 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx b/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx
index 742692f555..5f8e553ab9 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx
@@ -374,7 +374,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -618,7 +618,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx b/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx
index 404601d8f4..79c01861d7 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx b/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx
index de6e4babb6..0b38c01776 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx
@@ -46,7 +46,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -125,7 +125,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx b/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx
index 67a5c02802..ecaa0be8f6 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=" && yarn deploy'
 
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx b/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx
index 7e6615d884..40fcb7cd9f 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -411,7 +411,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -437,7 +437,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -697,7 +697,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [``](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx
index 30ffdb9faf..ce32424a25 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx
index 250342e26b..6e27e6be77 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx
index c1acd0195b..d9934e3bce 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx
index edaa670c6d..b812da5e33 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx
index 1e358a12fe..77789ebf47 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx
@@ -400,7 +400,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx
index df27a964f0..2b5657f48d 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx
index 6f87578892..e2f1dab444 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -512,7 +512,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -644,13 +644,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
-:::caution MDX is whitespace insensitive +:::warning MDX is whitespace insensitive MDX is in line with JSX behavior: line break characters, even when inside `
`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx
index 2da4138783..980f8dc99e 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx
index 1b1a8ad38d..74aa4349e5 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@5 rehype-katex@6
 ```
 
-:::caution
+:::warning
 
 Make sure to use `remark-math >= 5` and `rehype-katex >= 6` for Docusaurus v3 (using MDX v2).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx
index 1db6a6a67e..00c45da6b1 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx
@@ -57,7 +57,7 @@ Next, the `rehype-katex` operates on the Hypertext AST where everything has been
 
 
 
-:::caution
+:::warning
 
 Many official Remark/Rehype plugins are using ES Modules, a new JavaScript module system, which Docusaurus doesn't support yet. To work around this issue, we recommend to use dynamic `import()` inside an `async` config creation function.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx
index 9c1272f9a5..8805651886 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx
@@ -87,7 +87,7 @@ I can write **Markdown** alongside my _JSX_!
 
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -213,7 +213,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [an `MDXProvider`](https://mdxjs.com/docs/using-mdx/#mdx-provider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -334,7 +334,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f25..bfc161c542 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx
index b57dbb71e0..b10c9246d8 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -394,7 +394,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -443,7 +443,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx
index 7e9de4cbb7..45057041fc 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx
@@ -96,7 +96,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -123,7 +123,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`Download this document
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `` / ``, nothing will be done.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx b/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx
index af653e8141..68e872ff6c 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx
@@ -215,7 +215,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx b/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx
index 45f216420c..6f4759c50d 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.