From 4c6f67e1bec832408e609ac555ea67100da4fa81 Mon Sep 17 00:00:00 2001
From: Sycamore <71297412+samuelsycamore@users.noreply.github.com>
Date: Wed, 25 Sep 2024 13:06:29 -0400
Subject: [PATCH] [system] Add migration guide link to `@mui/styles` pages
 (#43833)

---
 docs/data/styles/advanced/advanced.md | 5 ++---
 docs/data/styles/api/api.md           | 5 ++---
 docs/data/styles/basics/basics.md     | 5 ++---
 pnpm-lock.yaml                        | 1 +
 4 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/docs/data/styles/advanced/advanced.md b/docs/data/styles/advanced/advanced.md
index f56a62d16ac91b..1843a4d9a52ccf 100644
--- a/docs/data/styles/advanced/advanced.md
+++ b/docs/data/styles/advanced/advanced.md
@@ -4,13 +4,12 @@
 
 :::error
 `@mui/styles` was deprecated with the release of MUI Core v5 in late 2021.
-It depended on [JSS](https://cssinjs.org/) as a styling solution, which is no longer used in `@mui/material`.
-
-`@mui/styles` is not compatible with [React.StrictMode](https://react.dev/reference/react/StrictMode) or React 18, and it will not be updated.
+It is not compatible with [React.StrictMode](https://react.dev/reference/react/StrictMode) or React 18+, and it will not be updated.
 
 This documentation remains here for those working on legacy projects, but we **strongly discourage** you from using `@mui/styles` when creating a new app with Material UI—you _will_ face unresolvable dependency issues.
 
 Please use [`@mui/system`](/system/getting-started/) instead.
+See the [v5 migration docs](/material-ui/migration/migrating-from-jss/) for details on how to migrate away from `@mui/styles`.
 :::
 
 ## Theming
diff --git a/docs/data/styles/api/api.md b/docs/data/styles/api/api.md
index 838f3e5cb32ca5..b4f521e33f3260 100644
--- a/docs/data/styles/api/api.md
+++ b/docs/data/styles/api/api.md
@@ -8,13 +8,12 @@ title: Styles API
 
 :::error
 `@mui/styles` was deprecated with the release of MUI Core v5 in late 2021.
-It depended on [JSS](https://cssinjs.org/) as a styling solution, which is no longer used in `@mui/material`.
-
-`@mui/styles` is not compatible with [React.StrictMode](https://react.dev/reference/react/StrictMode) or React 18, and it will not be updated.
+It is not compatible with [React.StrictMode](https://react.dev/reference/react/StrictMode) or React 18+, and it will not be updated.
 
 This documentation remains here for those working on legacy projects, but we **strongly discourage** you from using `@mui/styles` when creating a new app with Material UI—you _will_ face unresolvable dependency issues.
 
 Please use [`@mui/system`](/system/getting-started/) instead.
+See the [v5 migration docs](/material-ui/migration/migrating-from-jss/) for details on how to migrate away from `@mui/styles`.
 :::
 
 ## `createGenerateClassName([options]) => class name generator`
diff --git a/docs/data/styles/basics/basics.md b/docs/data/styles/basics/basics.md
index f654a750ce5d72..b81772ce418575 100644
--- a/docs/data/styles/basics/basics.md
+++ b/docs/data/styles/basics/basics.md
@@ -4,13 +4,12 @@
 
 :::error
 `@mui/styles` was deprecated with the release of MUI Core v5 in late 2021.
-It depended on [JSS](https://cssinjs.org/) as a styling solution, which is no longer used in `@mui/material`.
-
-`@mui/styles` is not compatible with [React.StrictMode](https://react.dev/reference/react/StrictMode) or React 18, and it will not be updated.
+It is not compatible with [React.StrictMode](https://react.dev/reference/react/StrictMode) or React 18+, and it will not be updated.
 
 This documentation remains here for those working on legacy projects, but we **strongly discourage** you from using `@mui/styles` when creating a new app with Material UI—you _will_ face unresolvable dependency issues.
 
 Please use [`@mui/system`](/system/getting-started/) instead.
+See the [v5 migration docs](/material-ui/migration/migrating-from-jss/) for details on how to migrate away from `@mui/styles`.
 :::
 
 ## Installation
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index fcdda8a7dcf9f6..a45e0a4babf3d7 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -25939,3 +25939,4 @@ snapshots:
       react: 18.3.1
 
   zwitch@2.0.4: {}
+  
\ No newline at end of file