Amend version policy docs

docs/source/_inc/_branch-policy.md

@@ -31,11 +31,17 @@ canary
 
     If the pull request is a feature or a bugfix, and if the release manager deems it useful to the latest version's branch, they may ask you to backport it to that branch.
 
-`17.x.x`
-:   `17.x.x` is the current stable and actively developed branch in git.
-    Upon the final release of version `18.0.0`, the `17.x.x` branch line will be no longer supported.
+`18.x.x`
+:   `18.x.x` is the current stable and actively developed branch in git.
+    This version of Volto has the [same maintenance and support schedule as Plone 6.1](https://plone.org/download/release-schedule).
     Any new feature will be merged into the `main` branch, and only backported to and released in older versions, if the Volto Team approves it.
 
+`17.x.x`
+:   `17.x.x` is no longer supported and became legacy when Volto 18 was released.
+    It won't receive any bug fixes nor security updates.
+    It is recommended that you update to 18.x.x.
+    If you need a bug fix or security update for this version, please submit a pull request, and the Volto Team will review it to determine whether it's suitable to merge.
+
 `16.x.x`
 :   This version of Volto has the [same maintenance and support schedule as Plone 6.0](https://plone.org/download/release-schedule).
     It receives bug fixes and security updates.

docs/source/_inc/_semantic-ui-deprecation.md

@@ -0,0 +1,6 @@
+```{deprecated} Volto 18
+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.
+```

docs/source/contributing/version-policy.md

@@ -16,10 +16,16 @@ This chapter describes the versions of software that Volto supports and how Volt
 
 (volto-generator-compatibility-with-volto-label)=
 
-## `volto-generator` compatibility with Volto
+## `@plone/volto-generator` compatibility with Volto
 
-`volto-generator` is a tool that generates a Volto project.
-The following table describes the compatibility between versions of `volto-generator` and Volto.
+```{deprecated} Volto 18.0.0
+`@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.
+```
+
+`@plone/volto-generator` is a tool that generates a Volto project.
+The following table describes the compatibility between versions of `@plone/volto-generator` and Volto.
 
 | Generator version | Volto version |
 |-------------------|---------------|
@@ -40,10 +46,11 @@ We will always support the [latest major Plone release](https://plone.org/downlo
 
 The versions of Python that are supported in Volto depend on the version of Plone that you use.
 
-| Plone | Python       | Volto        |
-| ----- | ------------ | ------------ |
-| 6.0   | 3.8-3.11     | 16.0 or 17.0 |
-| 5.2   | 2.7, 3.6-3.8 | 15.0         |
+| Plone | Python       | Volto            |
+| ----- | ------------ | ---------------- |
+| 6.1   | 3.10-3.12    | 18.0.0           |
+| 6.0   | 3.8-3.12     | 16.0.0 or 17.0.0 |
+| 5.2   | 2.7, 3.6-3.8 | 15.0.0           |
 
 On Plone 6, we recommend using the known good set (KGS) of package versions that are specified in the Plone release.
 
@@ -72,8 +79,12 @@ Volto runs using [Node.js](https://nodejs.org/en).
 Volto supports only the latest two [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule).
 We recommend using the current LTS version.
 
-- Node.js 22 LTS: Supported since Volto 18.
-- Node.js 20 LTS: Supported since Volto 17.
+| Node.js | Volto       |
+| ------- | ----------- |
+| 20, 22  | Volto 18    |
+| 18, 20  | Volto 17    |
+| 16, 18  | Volto 16    |
+
 - 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.
@@ -83,11 +94,10 @@ We recommend using the current LTS version.
 
 (version-policy-supported-browsers)=
 
-## Supported browsers
+## Supported web browsers
 
-Volto works well with the current version of any modern browser—including Chrome, Firefox, Safari, and Edge—as well as their mobile flavors.
-
-We do not guarantee that outdated browsers, such as Internet Explorer 11, are supported by Volto.
+```{include} ../../_inc/_install-browser-reqs-volto.md
+```
 
 
 ## Branch policy

docs/source/theming/about-semantic.md

@@ -9,6 +9,9 @@ myst:
 
 # About Semantic UI
 
+```{include} ../_inc/_semantic-ui-deprecation.md
+```
+
 Volto uses [Semantic UI](https://semantic-ui.com/) and
 [React Semantic UI](https://react.semantic-ui.com)
 (via [semantic-ui-less](https://github.com/Semantic-Org/Semantic-UI-LESS))

docs/source/theming/custom-styling.md

@@ -11,6 +11,9 @@ myst:
 
 ## Semantic UI
 
+```{include} /_inc/_semanticui-deprecation.md
+```
+
 For styling our website in Volto we use Semantic UI. It uses LESS as
 the underlying technology. By default Volto uses the Pastanaga theme but any
 theme can be used. A theme has the following folder structure:

docs/source/theming/index.md

@@ -11,6 +11,8 @@ myst:
 
 This section of the documentation describes theming in Volto.
 
+```{include} /_inc/_semanticui-deprecation.md
+```
 
 ## Conceptual guides
 

docs/source/theming/semanticui-theming.md

@@ -9,6 +9,9 @@ myst:
 
 # Semantic UI Theming
 
+```{include} /_inc/_semanticui-deprecation.md
+```
+
 As we hinted previously, Semantic UI theming happens in several stages using several layers of inheritance.
 Let's discover each of these layers.
 

docs/source/theming/theming-engine.md

@@ -9,6 +9,9 @@ myst:
 
 # How does the theming engine work?
 
+```{include} /_inc/_semanticui-deprecation.md
+```
+
 It basically uses heavily the LESS precompiler language features. No code is involved (which is good).
 
 ## `theme.config`

docs/source/theming/theming-strategy.md

@@ -9,6 +9,9 @@ myst:
 
 # Theming Strategy
 
+```{include} /_inc/_semanticui-deprecation.md
+```
+
 One approaches the theming of a Volto site usually with a predefined mockup or
 design from a design agency or an UX/UI designer in the form of Sketch files
 (a common design and prototyping tool), a series of photoshop or PDFs with the

packages/volto/news/6541.documentation

@@ -0,0 +1,2 @@
+Amended version-policy docs. @sneridagh
+Added deprecation notice for Semantic UI theming.