[material-ui][docs] Add deprecations migration guide

docs/data/material/migration/migrating-deprecations/migrating-deprecations.md

@@ -0,0 +1,51 @@
+# 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 results in a better developer experience.
+The sooner you migrate, the smoother future major updates become.
+
+## Migrating
+
+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](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 linked below.
+
+:::
+
+## Accordion
+
+### TransitionComponent
+
+Deprecated in favor of `slots.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)).
+
+```diff
+ <Accordion
+-    TransitionComponent={CustomTransition}
++    slots={{ transition: CustomTransition }}
+ />
+```
+
+### TransitionProps
+
+Deprecated in favor of `slotProps.transition` ([Codemod](https://github.com/mui/material-ui/tree/master/packages/mui-codemod#accordion-props)).
+
+```diff
+ <Accordion
+-    TransitionProps={{ unmountOnExit: true }}
++    slotProps={{ transition: { unmountOnExit: true } }}
+ />
+```

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',

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",

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} />;
+}

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",

packages/mui-material/src/Accordion/Accordion.d.ts

@@ -79,15 +79,15 @@ 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> }
       >;
       /**
        * 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;

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,
 };