From 2e776b7106abac4cc0022f11e595a018429a0a5e Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Tue, 23 Jan 2024 15:48:08 -0300
Subject: [PATCH 1/9] Add deprecations migration guide

---
 .../migrating-deprecations.md                 | 69 +++++++++++++++++++
 docs/data/material/pages.ts                   |  4 ++
 .../migration/migrating-deprecations.js       |  7 ++
 docs/translations/translations.json           |  1 +
 4 files changed, 81 insertions(+)
 create mode 100644 docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
 create mode 100644 docs/pages/material-ui/migration/migrating-deprecations.js

diff --git a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
new file mode 100644
index 00000000000000..6a190352784e5c
--- /dev/null
+++ b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
@@ -0,0 +1,69 @@
+# Migrating deprecations
+
+<p class="description">This guide explains how to migrate current deprecated APIs.</p>
+
+## Why you should migrate
+
+Deprecations are added as APIs are improved.
+Migrating to these improved APIs will result in a better developer experience.
+The deprecated APIs will eventually be removed and become breaking changes.
+The sooner you migrate, the smoother future major updates will become.
+
+## Migrating
+
+The easiest way to migrate is running the deprecations codemod:
+
+```bash
+npx @mui/codemod@latest deprecations/all <path>
+```
+
+This will run all the current deprecations codemods, automatically migrating to the updated API.
+If you wish to run a particular codemod, search for the deprecation below for the specific command.
+
+### Manual migration
+
+If you need to manually migrate, examples are listed below for each deprecation.
+
+## Accordion
+
+### TransitionComponent
+
+Deprecated in favor of `slots.transition`.
+To migrate replace `TransitionComponent` with `slots.transition`:
+
+```diff
+ <Accordion
+-    TransitionComponent={CustomTransition}
++    slots={{ transition: CustomTransition }}
+ />
+```
+
+<details>
+<summary>Codemod command</summary>
+
+```bash
+npx @mui/codemod@latest deprecations/accordion-props <path>
+```
+
+</details>
+
+### TransitionProps
+
+Deprecated in favor of `slotProps.transition`.
+To migrate replace `TransitionProps` with `slotProps.transition`:
+
+```diff
+ <Accordion
+-    TransitionProps={{ unmountOnExit: true }}
++    slotProps={{ transition: { unmountOnExit: true } }}
+ />
+```
+
+<details>
+<summary>Codemod command</summary>
+
+```bash
+npx @mui/codemod@latest deprecations/accordion-props <path>
+```
+
+</details>
diff --git a/docs/data/material/pages.ts b/docs/data/material/pages.ts
index 1279434c9744ff..db882ca0c05982 100644
--- a/docs/data/material/pages.ts
+++ b/docs/data/material/pages.ts
@@ -257,6 +257,10 @@ const pages: MuiPage[] = [
     pathname: '/material-ui/migration',
     title: 'Migration',
     children: [
+      {
+        pathname: '/material-ui/migration/migrating-deprecations',
+        title: 'Migrating deprecations',
+      },
       {
         pathname: '/material-ui/migration/migration-grid-v2',
         title: 'Migrating to Grid v2',
diff --git a/docs/pages/material-ui/migration/migrating-deprecations.js b/docs/pages/material-ui/migration/migrating-deprecations.js
new file mode 100644
index 00000000000000..906b30705d7057
--- /dev/null
+++ b/docs/pages/material-ui/migration/migrating-deprecations.js
@@ -0,0 +1,7 @@
+import * as React from 'react';
+import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
+import * as pageProps from 'docs/data/material/migration/migrating-deprecations/migrating-deprecations.md?@mui/markdown';
+
+export default function Page() {
+  return <MarkdownDocs {...pageProps} />;
+}
diff --git a/docs/translations/translations.json b/docs/translations/translations.json
index 235068f3aebe15..389ba3e08e08fd 100644
--- a/docs/translations/translations.json
+++ b/docs/translations/translations.json
@@ -473,6 +473,7 @@
     "/material-ui/discover-more/vision": "Vision",
     "/material-ui/discover-more/changelog": "Changelog",
     "/material-ui/migration": "Migration",
+    "/material-ui/migration/migrating-deprecations": "Migrating deprecations",
     "/material-ui/migration/migration-grid-v2": "Migrating to Grid v2",
     "Upgrade to v5": "Upgrade to v5",
     "/material-ui/migration/migration-v4": "Migrating to v5: getting started",

From cf4d74b27af1cc8e4cd92664c85243fc10f987d8 Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Tue, 23 Jan 2024 15:57:23 -0300
Subject: [PATCH 2/9] Address reviewdog review

---
 .../migrating-deprecations/migrating-deprecations.md       | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
index 6a190352784e5c..6b4cfd3902a73c 100644
--- a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
+++ b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
@@ -5,9 +5,8 @@
 ## Why you should migrate
 
 Deprecations are added as APIs are improved.
-Migrating to these improved APIs will result in a better developer experience.
-The deprecated APIs will eventually be removed and become breaking changes.
-The sooner you migrate, the smoother future major updates will become.
+Migrating to these improved APIs results in a better developer experience.
+The sooner you migrate, the smoother future major updates become.
 
 ## Migrating
 
@@ -17,7 +16,7 @@ The easiest way to migrate is running the deprecations codemod:
 npx @mui/codemod@latest deprecations/all <path>
 ```
 
-This will run all the current deprecations codemods, automatically migrating to the updated API.
+This command runs all the current deprecations codemods, automatically migrating to the updated API.
 If you wish to run a particular codemod, search for the deprecation below for the specific command.
 
 ### Manual migration

From c7364298405dba3b6416b732c562478449aec367 Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Thu, 25 Jan 2024 16:24:45 -0300
Subject: [PATCH 3/9] Improve copy and add placeholder links

---
 .../migrating-deprecations.md                 | 25 ++++++++++++-------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
index 6b4cfd3902a73c..13225e4e970f55 100644
--- a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
+++ b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
@@ -10,25 +10,27 @@ The sooner you migrate, the smoother future major updates become.
 
 ## Migrating
 
-The easiest way to migrate is running the deprecations codemod:
+The easiest way to migrate is running the `deprecations/all` codemod:
 
 ```bash
 npx @mui/codemod@latest deprecations/all <path>
 ```
 
-This command runs all the current deprecations codemods, automatically migrating to the updated API.
-If you wish to run a particular codemod, search for the deprecation below for the specific command.
+This command runs all the current [deprecations codemods](#/), automatically migrating to the updated API.
+This codemod can be run multiple times to keep up with new deprecations.
 
-### Manual migration
+:::info
 
-If you need to manually migrate, examples are listed below for each deprecation.
+If you need to migrate a deprecation manually, examples on how to do so are listed below for each current deprecation.
+If you need to run a specific codemod, those are also listed for each deprecation.
+
+:::
 
 ## Accordion
 
 ### TransitionComponent
 
 Deprecated in favor of `slots.transition`.
-To migrate replace `TransitionComponent` with `slots.transition`:
 
 ```diff
  <Accordion
@@ -38,7 +40,10 @@ To migrate replace `TransitionComponent` with `slots.transition`:
 ```
 
 <details>
-<summary>Codemod command</summary>
+<summary>Codemod</summary>
+<br/>
+
+Run the codemod for this deprecation with the following command ([source](#/))
 
 ```bash
 npx @mui/codemod@latest deprecations/accordion-props <path>
@@ -49,7 +54,6 @@ npx @mui/codemod@latest deprecations/accordion-props <path>
 ### TransitionProps
 
 Deprecated in favor of `slotProps.transition`.
-To migrate replace `TransitionProps` with `slotProps.transition`:
 
 ```diff
  <Accordion
@@ -59,7 +63,10 @@ To migrate replace `TransitionProps` with `slotProps.transition`:
 ```
 
 <details>
-<summary>Codemod command</summary>
+<summary>Codemod</summary>
+<br/>
+
+Run the codemod for this deprecation with the following command ([source](#/))
 
 ```bash
 npx @mui/codemod@latest deprecations/accordion-props <path>

From d1cce84fe70847c521bc35e1e7429f31a6245f80 Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Tue, 30 Jan 2024 16:42:56 -0300
Subject: [PATCH 4/9] Add links and reduce duplication

---
 .../migrating-deprecations.md                 | 32 +++----------------
 1 file changed, 4 insertions(+), 28 deletions(-)

diff --git a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
index 13225e4e970f55..69cd7f27b378ca 100644
--- a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
+++ b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
@@ -16,13 +16,13 @@ The easiest way to migrate is running the `deprecations/all` codemod:
 npx @mui/codemod@latest deprecations/all <path>
 ```
 
-This command runs all the current [deprecations codemods](#/), automatically migrating to the updated API.
+This command runs all the current [deprecations codemods](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#deprecations), automatically migrating to the updated API.
 This codemod can be run multiple times to keep up with new deprecations.
 
 :::info
 
 If you need to migrate a deprecation manually, examples on how to do so are listed below for each current deprecation.
-If you need to run a specific codemod, those are also listed for each deprecation.
+If you need to run a specific codemod, those are also linked below.
 
 :::
 
@@ -30,7 +30,7 @@ If you need to run a specific codemod, those are also listed for each deprecatio
 
 ### TransitionComponent
 
-Deprecated in favor of `slots.transition`.
+Deprecated in favor of `slots.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)).
 
 ```diff
  <Accordion
@@ -39,21 +39,9 @@ Deprecated in favor of `slots.transition`.
  />
 ```
 
-<details>
-<summary>Codemod</summary>
-<br/>
-
-Run the codemod for this deprecation with the following command ([source](#/))
-
-```bash
-npx @mui/codemod@latest deprecations/accordion-props <path>
-```
-
-</details>
-
 ### TransitionProps
 
-Deprecated in favor of `slotProps.transition`.
+Deprecated in favor of `slotProps.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)).
 
 ```diff
  <Accordion
@@ -61,15 +49,3 @@ Deprecated in favor of `slotProps.transition`.
 +    slotProps={{ transition: { unmountOnExit: true } }}
  />
 ```
-
-<details>
-<summary>Codemod</summary>
-<br/>
-
-Run the codemod for this deprecation with the following command ([source](#/))
-
-```bash
-npx @mui/codemod@latest deprecations/accordion-props <path>
-```
-
-</details>

From 43fb3c695e56503b23e5623add30db0b1247b0ff Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Tue, 30 Jan 2024 16:57:53 -0300
Subject: [PATCH 5/9] Add link in deprecated Accordion props to guide

---
 docs/pages/material-ui/api/accordion.json          | 4 ++--
 packages/mui-material/src/Accordion/Accordion.d.ts | 4 ++--
 packages/mui-material/src/Accordion/Accordion.js   | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/pages/material-ui/api/accordion.json b/docs/pages/material-ui/api/accordion.json
index c648b2abdff691..8f0f0167003dbb 100644
--- a/docs/pages/material-ui/api/accordion.json
+++ b/docs/pages/material-ui/api/accordion.json
@@ -32,12 +32,12 @@
     "TransitionComponent": {
       "type": { "name": "elementType" },
       "deprecated": true,
-      "deprecationInfo": "Use <code>slots.transition</code> instead. This prop will be removed in v7."
+      "deprecationInfo": "Use <code>slots.transition</code> instead. This prop will be removed in v7. <a href=\"/material-ui/migration/migrating-deprecations/\">How to migrate</a>."
     },
     "TransitionProps": {
       "type": { "name": "object" },
       "deprecated": true,
-      "deprecationInfo": "Use <code>slotProps.transition</code> instead. This prop will be removed in v7."
+      "deprecationInfo": "Use <code>slotProps.transition</code> instead. This prop will be removed in v7. <a href=\"/material-ui/migration/migrating-deprecations/\">How to migrate</a>."
     }
   },
   "name": "Accordion",
diff --git a/packages/mui-material/src/Accordion/Accordion.d.ts b/packages/mui-material/src/Accordion/Accordion.d.ts
index 2b6a15fbc26a37..88b1e4b99000fe 100644
--- a/packages/mui-material/src/Accordion/Accordion.d.ts
+++ b/packages/mui-material/src/Accordion/Accordion.d.ts
@@ -79,7 +79,7 @@ export type AccordionTypeMap<
       /**
        * The component used for the transition.
        * [Follow this guide](/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
-       * @deprecated Use `slots.transition` instead. This prop will be removed in v7.
+       * @deprecated Use `slots.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
        */
       TransitionComponent?: React.JSXElementConstructor<
         TransitionProps & { children?: React.ReactElement<any, any> }
@@ -87,7 +87,7 @@ export type AccordionTypeMap<
       /**
        * Props applied to the transition element.
        * By default, the element is based on this [`Transition`](http://reactcommunity.org/react-transition-group/transition/) component.
-       * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7.
+       * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
        */
       TransitionProps?: TransitionProps;
     } & AccordionSlotsAndSlotProps;
diff --git a/packages/mui-material/src/Accordion/Accordion.js b/packages/mui-material/src/Accordion/Accordion.js
index e890d2f7ad7768..52ca72429f3683 100644
--- a/packages/mui-material/src/Accordion/Accordion.js
+++ b/packages/mui-material/src/Accordion/Accordion.js
@@ -293,13 +293,13 @@ Accordion.propTypes /* remove-proptypes */ = {
   /**
    * The component used for the transition.
    * [Follow this guide](/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
-   * @deprecated Use `slots.transition` instead. This prop will be removed in v7.
+   * @deprecated Use `slots.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
    */
   TransitionComponent: PropTypes.elementType,
   /**
    * Props applied to the transition element.
    * By default, the element is based on this [`Transition`](http://reactcommunity.org/react-transition-group/transition/) component.
-   * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7.
+   * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
    */
   TransitionProps: PropTypes.object,
 };

From 4cc8786cc44fa54e8bb95ab7294a1eefa82696e6 Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Wed, 31 Jan 2024 14:20:47 -0300
Subject: [PATCH 6/9] Apply suggestions from code review

Co-authored-by: Sam Sycamore <71297412+samuelsycamore@users.noreply.github.com>
Signed-off-by: Diego Andai <diego@mui.com>
---
 .../migrating-deprecations.md                      | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
index 69cd7f27b378ca..d8f7197d8e66db 100644
--- a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
+++ b/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
@@ -1,27 +1,27 @@
 # Migrating deprecations
 
-<p class="description">This guide explains how to migrate current deprecated APIs.</p>
+<p class="description">Learn how to migrate away from recently deprecated APIs before they become breaking changes.</p>
 
 ## Why you should migrate
 
-Deprecations are added as APIs are improved.
-Migrating to these improved APIs results in a better developer experience.
-The sooner you migrate, the smoother future major updates become.
+Features become deprecated over time as maintainers make improvements to the APIs.
+Migrating to these improved APIs results in a better developer experience, so it's in your best interest to stay up to date.
+Deprecated APIs often become breaking changes in subsequent major versions, so the sooner you migrate, the smoother the next major update will be.
 
 ## Migrating
 
-The easiest way to migrate is running the `deprecations/all` codemod:
+Material UI provides the `deprecations/all` codemod to help you stay up to date with minimal effort.
 
 ```bash
 npx @mui/codemod@latest deprecations/all <path>
 ```
 
 This command runs all the current [deprecations codemods](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#deprecations), automatically migrating to the updated API.
-This codemod can be run multiple times to keep up with new deprecations.
+You can run this codemod as often as necessary to keep up with the latest changes.
 
 :::info
 
-If you need to migrate a deprecation manually, examples on how to do so are listed below for each current deprecation.
+If you need to manually migrate from a deprecated API, you can find examples below for all deprecations that have been added in Material UI v5.
 If you need to run a specific codemod, those are also linked below.
 
 :::

From a652ff438245a3571aece9e510e3e2e9a2724231 Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Wed, 31 Jan 2024 15:21:23 -0300
Subject: [PATCH 7/9] Update file names and copy

---
 .../migrating-from-deprecated-apis.md}                      | 6 +++---
 docs/data/material/pages.ts                                 | 4 ++--
 docs/pages/material-ui/api/accordion.json                   | 4 ++--
 ...ng-deprecations.js => migrating-from-deprecated-APIs.js} | 2 +-
 docs/translations/translations.json                         | 2 +-
 packages/mui-material/src/Accordion/Accordion.d.ts          | 4 ++--
 packages/mui-material/src/Accordion/Accordion.js            | 4 ++--
 7 files changed, 13 insertions(+), 13 deletions(-)
 rename docs/data/material/migration/{migrating-deprecations/migrating-deprecations.md => migrating-from-deprecated-apis/migrating-from-deprecated-apis.md} (78%)
 rename docs/pages/material-ui/migration/{migrating-deprecations.js => migrating-from-deprecated-APIs.js} (76%)

diff --git a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md b/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
similarity index 78%
rename from docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
rename to docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
index d8f7197d8e66db..6411099a6da400 100644
--- a/docs/data/material/migration/migrating-deprecations/migrating-deprecations.md
+++ b/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
@@ -1,4 +1,4 @@
-# Migrating deprecations
+# Migrating from deprecated APIs
 
 <p class="description">Learn how to migrate away from recently deprecated APIs before they become breaking changes.</p>
 
@@ -30,7 +30,7 @@ If you need to run a specific codemod, those are also linked below.
 
 ### TransitionComponent
 
-Deprecated in favor of `slots.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)).
+The Accordion's `TransitionComponent` was deprecated in favor of `slots.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)):
 
 ```diff
  <Accordion
@@ -41,7 +41,7 @@ Deprecated in favor of `slots.transition` ([Codemod](https://github.com/mui/mate
 
 ### TransitionProps
 
-Deprecated in favor of `slotProps.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)).
+The Accordion's `TransitionProps` was deprecated in favor of `slotProps.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)):
 
 ```diff
  <Accordion
diff --git a/docs/data/material/pages.ts b/docs/data/material/pages.ts
index db882ca0c05982..944b114eeb0102 100644
--- a/docs/data/material/pages.ts
+++ b/docs/data/material/pages.ts
@@ -258,8 +258,8 @@ const pages: MuiPage[] = [
     title: 'Migration',
     children: [
       {
-        pathname: '/material-ui/migration/migrating-deprecations',
-        title: 'Migrating deprecations',
+        pathname: '/material-ui/migration/migrating-from-deprecated-apis',
+        title: 'Migrating from deprecated APIs',
       },
       {
         pathname: '/material-ui/migration/migration-grid-v2',
diff --git a/docs/pages/material-ui/api/accordion.json b/docs/pages/material-ui/api/accordion.json
index 8f0f0167003dbb..5a034bc834124a 100644
--- a/docs/pages/material-ui/api/accordion.json
+++ b/docs/pages/material-ui/api/accordion.json
@@ -32,12 +32,12 @@
     "TransitionComponent": {
       "type": { "name": "elementType" },
       "deprecated": true,
-      "deprecationInfo": "Use <code>slots.transition</code> instead. This prop will be removed in v7. <a href=\"/material-ui/migration/migrating-deprecations/\">How to migrate</a>."
+      "deprecationInfo": "Use <code>slots.transition</code> instead. This prop will be removed in v7. <a href=\"/material-ui/migration/migrating-from-deprecated-apis/\">How to migrate</a>."
     },
     "TransitionProps": {
       "type": { "name": "object" },
       "deprecated": true,
-      "deprecationInfo": "Use <code>slotProps.transition</code> instead. This prop will be removed in v7. <a href=\"/material-ui/migration/migrating-deprecations/\">How to migrate</a>."
+      "deprecationInfo": "Use <code>slotProps.transition</code> instead. This prop will be removed in v7. <a href=\"/material-ui/migration/migrating-from-deprecated-apis/\">How to migrate</a>."
     }
   },
   "name": "Accordion",
diff --git a/docs/pages/material-ui/migration/migrating-deprecations.js b/docs/pages/material-ui/migration/migrating-from-deprecated-APIs.js
similarity index 76%
rename from docs/pages/material-ui/migration/migrating-deprecations.js
rename to docs/pages/material-ui/migration/migrating-from-deprecated-APIs.js
index 906b30705d7057..dfba929b2b1aff 100644
--- a/docs/pages/material-ui/migration/migrating-deprecations.js
+++ b/docs/pages/material-ui/migration/migrating-from-deprecated-APIs.js
@@ -1,6 +1,6 @@
 import * as React from 'react';
 import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
-import * as pageProps from 'docs/data/material/migration/migrating-deprecations/migrating-deprecations.md?@mui/markdown';
+import * as pageProps from 'docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md?@mui/markdown';
 
 export default function Page() {
   return <MarkdownDocs {...pageProps} />;
diff --git a/docs/translations/translations.json b/docs/translations/translations.json
index 389ba3e08e08fd..d1a58baacbd347 100644
--- a/docs/translations/translations.json
+++ b/docs/translations/translations.json
@@ -473,7 +473,7 @@
     "/material-ui/discover-more/vision": "Vision",
     "/material-ui/discover-more/changelog": "Changelog",
     "/material-ui/migration": "Migration",
-    "/material-ui/migration/migrating-deprecations": "Migrating deprecations",
+    "/material-ui/migration/migrating-from-deprecated-apis": "Migrating from deprecated APIs",
     "/material-ui/migration/migration-grid-v2": "Migrating to Grid v2",
     "Upgrade to v5": "Upgrade to v5",
     "/material-ui/migration/migration-v4": "Migrating to v5: getting started",
diff --git a/packages/mui-material/src/Accordion/Accordion.d.ts b/packages/mui-material/src/Accordion/Accordion.d.ts
index 88b1e4b99000fe..a84a42c563d7fb 100644
--- a/packages/mui-material/src/Accordion/Accordion.d.ts
+++ b/packages/mui-material/src/Accordion/Accordion.d.ts
@@ -79,7 +79,7 @@ export type AccordionTypeMap<
       /**
        * The component used for the transition.
        * [Follow this guide](/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
-       * @deprecated Use `slots.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
+       * @deprecated Use `slots.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-from-deprecated-apis/).
        */
       TransitionComponent?: React.JSXElementConstructor<
         TransitionProps & { children?: React.ReactElement<any, any> }
@@ -87,7 +87,7 @@ export type AccordionTypeMap<
       /**
        * Props applied to the transition element.
        * By default, the element is based on this [`Transition`](http://reactcommunity.org/react-transition-group/transition/) component.
-       * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
+       * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-from-deprecated-apis/).
        */
       TransitionProps?: TransitionProps;
     } & AccordionSlotsAndSlotProps;
diff --git a/packages/mui-material/src/Accordion/Accordion.js b/packages/mui-material/src/Accordion/Accordion.js
index 52ca72429f3683..5483c88ad1f670 100644
--- a/packages/mui-material/src/Accordion/Accordion.js
+++ b/packages/mui-material/src/Accordion/Accordion.js
@@ -293,13 +293,13 @@ Accordion.propTypes /* remove-proptypes */ = {
   /**
    * The component used for the transition.
    * [Follow this guide](/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
-   * @deprecated Use `slots.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
+   * @deprecated Use `slots.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-from-deprecated-apis/).
    */
   TransitionComponent: PropTypes.elementType,
   /**
    * Props applied to the transition element.
    * By default, the element is based on this [`Transition`](http://reactcommunity.org/react-transition-group/transition/) component.
-   * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-deprecations/).
+   * @deprecated Use `slotProps.transition` instead. This prop will be removed in v7. [How to migrate](/material-ui/migration/migrating-from-deprecated-apis/).
    */
   TransitionProps: PropTypes.object,
 };

From f8af7dedc35eb4ec2e773154ff99c9408fa00b06 Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Mon, 5 Feb 2024 15:31:04 -0300
Subject: [PATCH 8/9] Replace regular space with non-breaking space

---
 .../migrating-from-deprecated-apis.md                         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md b/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
index 6411099a6da400..e583aaa31d0fda 100644
--- a/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
+++ b/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
@@ -10,7 +10,7 @@ Deprecated APIs often become breaking changes in subsequent major versions, so t
 
 ## Migrating
 
-Material UI provides the `deprecations/all` codemod to help you stay up to date with minimal effort.
+Material UI provides the `deprecations/all` codemod to help you stay up to date with minimal effort.
 
 ```bash
 npx @mui/codemod@latest deprecations/all <path>
@@ -21,7 +21,7 @@ You can run this codemod as often as necessary to keep up with the latest change
 
 :::info
 
-If you need to manually migrate from a deprecated API, you can find examples below for all deprecations that have been added in Material UI v5.
+If you need to manually migrate from a deprecated API, you can find examples below for all deprecations that have been added in Material UI v5.
 If you need to run a specific codemod, those are also linked below.
 
 :::

From 46623cbc084110962f817ebc1ef2cc06c032eede Mon Sep 17 00:00:00 2001
From: Diego Andai <diego@mui.com>
Date: Mon, 5 Feb 2024 17:13:03 -0300
Subject: [PATCH 9/9] trigger ci