First version

plone · Dec 14, 2024 · 10459fd · 10459fd
1 parent 086f950
commit 10459fd
Show file tree

Hide file tree

Showing 3 changed files with 41 additions and 14 deletions.
diff --git a/docs/source/_inc/_branch-policy.md b/docs/source/_inc/_branch-policy.md
@@ -31,11 +31,14 @@ 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.
+    Upon the final release of version `19.0.0`, the `18.x.x` branch line will be no longer supported.
     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.
+
 `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.

diff --git a/docs/source/_inc/_install-browser-reqs-volto.md b/docs/source/_inc/_install-browser-reqs-volto.md
@@ -0,0 +1,10 @@
+You can view the list of supported browsers for Volto at [Browserslist](https://browsersl.ist/#q=%3E1%25%0Alast+4+versions%0AFirefox+ESR%0Anot+dead).
+
+These browsers are set according to the `browserslist` key in Volto's [`package.json`](https://github.com/plone/volto/blob/1aff8d0451f5cb375ca9f5afe9b2b72a0555afd8/packages/volto/package.json#L170-L176) file, whose content is below.
+
+```shell
+>1%
+last 4 versions
+Firefox ESR
+not dead
+```
diff --git a/docs/source/contributing/version-policy.md b/docs/source/contributing/version-policy.md
@@ -16,10 +16,18 @@ 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
+
+```{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.
+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.
+```
+
+`@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 +48,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.11     | 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,6 +81,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 | Volto       |
+| ------- | ----------- |
+| 20, 22  | Volto 18    |
+| 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.
@@ -83,11 +98,10 @@ We recommend using the current LTS version.
 
 (version-policy-supported-browsers)=
 
-## Supported browsers
-
-Volto works well with the current version of any modern browser—including Chrome, Firefox, Safari, and Edge—as well as their mobile flavors.
+### Supported web browsers
 
-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