diff --git a/docs/source/_inc/_branch-policy.md b/docs/source/_inc/_branch-policy.md index 22046b8266..90a522a990 100644 --- 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 new file mode 100644 index 0000000000..b5db8d42ac --- /dev/null +++ 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 index fe42d3d1d5..e686e5ec45 100644 --- 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