Apply suggestions from code review

Co-authored-by: Steve Piercy <[email protected]>
plone · Dec 15, 2024 · 7d0d06d · 7d0d06d
1 parent 1a3ddef
commit 7d0d06d
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 9 deletions.
diff --git a/docs/source/contributing/version-policy.md b/docs/source/contributing/version-policy.md
@@ -19,10 +19,9 @@ This chapter describes the versions of software that Volto supports and how Volt
 ## `@plone/volto-generator` compatibility with Volto
 
 ```{deprecated} Volto 18.0.0
-
-```{important}
-`@plone/volto-generator` is deprecated, unmaintaned, and its usage is discouraged from Volto 18.0.0.
-For new projects, please use [Cookieplone](https://github.com/plone/cookieplone) instead.
+`@plone/volto-generator` was deprecated in Volto 18.0.0.
+It is not maintained, and you should not use it.
+For new projects, use [Cookieplone](https://github.com/plone/cookieplone) instead.
 In case of having an existing project and you need to upgrade to Volto 18 but don't have time to migrate to use Cookieplone, you can still use it.
 ```
 
@@ -87,8 +86,6 @@ We recommend using the current LTS version.
 | 18, 20  | Volto 17    |
 | 16, 18  | Volto 16    |
 
-- Node.js 22 LTS: Supported since Volto 18.
-- Node.js 20 LTS: Supported since Volto 17.
 - Node.js 18: No longer supported. It was supported in Volto 16 - 17.
 - Node.js 16: No longer supported. It was supported in Volto 14 - 16.
 - Node.js 14: No longer supported. It was supported in Volto 8.8.0 - 16.
@@ -98,7 +95,7 @@ We recommend using the current LTS version.
 
 (version-policy-supported-browsers)=
 
-### Supported web browsers
+## Supported web browsers
 
 ```{include} /_inc/_install-browser-reqs-volto.md
 ```

diff --git a/docs/source/theming/about-semantic.md b/docs/source/theming/about-semantic.md
@@ -10,8 +10,10 @@ myst:
 # About Semantic UI
 
 ```{deprecated} Volto 18
-Using SemanticUI theming for your project or add-on is deprecated from Volto 18 on and will be removed from Plone 7.
-Plone 7 will use another theming approach, based on `@plone/components` and `@plone/theming` packages.
+Semantic UI development and maintenance has sputtered since 2018.
+The Volto Team made the decision to move forward in a sustainable direction.
+Plone 7 will use a different theming approach, based on the [`@plone/components`](https://www.npmjs.com/package/@plone/components)—which in turn is based on [React Aria Components](https://react-spectrum.adobe.com/react-aria/components.html)—and [`@plone/theming`](https://github.com/plone/volto/tree/main/packages/theming) packages.
+Using Semantic UI theming for your project or add-on is deprecated from Volto 18 onward, and will be removed in Plone 7.
 ```
 
 Volto uses [Semantic UI](https://semantic-ui.com/) and