From b03cbcdd86db98b067ae5a51da1fb7ed8b2c4a48 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Fri, 22 May 2026 04:41:17 -0700 Subject: [PATCH 1/3] Prepare for 6.3 final release - In plone/documentation's conf.py update PLONE_BACKEND_MINOR_VERSION. - In plone/documentation's conf.py update SUPPORTED_PYTHON_VERSIONS_PLONE##. - Create a new include file docs/_inc/_install-python-plone##.md, and update its content. - Update files that use these substitions and includes --- docs/_inc/_install-python-plone63.md | 9 +++++++++ docs/admin-guide/install-buildout.md | 4 ++-- docs/admin-guide/install-pip.md | 4 ++-- docs/conf.py | 3 ++- docs/contributing/core/index.md | 4 ++-- docs/contributing/documentation/setup-build.md | 4 ++-- 6 files changed, 19 insertions(+), 9 deletions(-) create mode 100644 docs/_inc/_install-python-plone63.md diff --git a/docs/_inc/_install-python-plone63.md b/docs/_inc/_install-python-plone63.md new file mode 100644 index 0000000000..18551c7b4d --- /dev/null +++ b/docs/_inc/_install-python-plone63.md @@ -0,0 +1,9 @@ +Installing Python is beyond the scope of this documentation. +However, it is recommended to use a Python version manager, such as {term}`uv` or {term}`pyenv`, that allows you to install multiple versions of Python on your development environment without destroying your system's Python. + +```{warning} +Do not create or activate a Python virtual environment at this time. +The instructions below will create one. +``` + +Plone 6.3 requires Python version {{SUPPORTED_PYTHON_VERSIONS_PLONE63}}. diff --git a/docs/admin-guide/install-buildout.md b/docs/admin-guide/install-buildout.md index ede20dcaca..7864381787 100644 --- a/docs/admin-guide/install-buildout.md +++ b/docs/admin-guide/install-buildout.md @@ -31,12 +31,12 @@ For other installation options, see {ref}`get-started-install-label`. ## Prerequisites for installation -- For Plone 6.2, Python {{SUPPORTED_PYTHON_VERSIONS_PLONE62}} +- For Plone 6.3, Python {{SUPPORTED_PYTHON_VERSIONS_PLONE63}} ### Python -```{include} /_inc/_install-python-plone62.md +```{include} /_inc/_install-python-plone63.md ``` diff --git a/docs/admin-guide/install-pip.md b/docs/admin-guide/install-pip.md index 54990f9c5a..1a23e6219a 100644 --- a/docs/admin-guide/install-pip.md +++ b/docs/admin-guide/install-pip.md @@ -31,12 +31,12 @@ For other installation options, see {ref}`get-started-install-label`. ## Prerequisites for installation -- For Plone 6.2, Python {{SUPPORTED_PYTHON_VERSIONS_PLONE62}} +- For Plone 6.3, Python {{SUPPORTED_PYTHON_VERSIONS_PLONE63}} ### Python -```{include} /_inc/_install-python-plone62.md +```{include} /_inc/_install-python-plone63.md ``` diff --git a/docs/conf.py b/docs/conf.py index ce9fd132d1..42807b7b0d 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -326,6 +326,7 @@ "SUPPORTED_PYTHON_VERSIONS_PLONE60": "3.9, 3.10, 3.11, 3.12, or 3.13", "SUPPORTED_PYTHON_VERSIONS_PLONE61": "3.10, 3.11, 3.12, or 3.13", "SUPPORTED_PYTHON_VERSIONS_PLONE62": "3.10, 3.11, 3.12, 3.13, or 3.14", + "SUPPORTED_PYTHON_VERSIONS_PLONE63": "3.11, 3.12, 3.13, or 3.14", } @@ -474,7 +475,7 @@ def source_replace(app, docname, source): # Dict of replacements. source_replacements = { - "{PLONE_BACKEND_MINOR_VERSION}": "6.2", + "{PLONE_BACKEND_MINOR_VERSION}": "6.3", } diff --git a/docs/contributing/core/index.md b/docs/contributing/core/index.md index 35c72bc864..e4a727e0e2 100644 --- a/docs/contributing/core/index.md +++ b/docs/contributing/core/index.md @@ -38,7 +38,7 @@ However, the following links and sections below may be helpful. ```{include} ../../volto/_inc/_install-operating-system.md ``` -- Python {{SUPPORTED_PYTHON_VERSIONS_PLONE61}} +- Python {{SUPPORTED_PYTHON_VERSIONS_PLONE63}} - {term}`GNU make` - {term}`Git` - A C compiler @@ -48,7 +48,7 @@ However, the following links and sections below may be helpful. Installing Python is beyond the scope of this documentation. However, it is recommended to use a Python version manager, {term}`pyenv` that allows you to install multiple versions of Python on your development environment without destroying your system's Python. -Plone requires Python version {{SUPPORTED_PYTHON_VERSIONS_PLONE62}}. +Plone requires Python version {{SUPPORTED_PYTHON_VERSIONS_PLONE63}}. ### Make diff --git a/docs/contributing/documentation/setup-build.md b/docs/contributing/documentation/setup-build.md index d6aa8eabec..4c273ee81f 100644 --- a/docs/contributing/documentation/setup-build.md +++ b/docs/contributing/documentation/setup-build.md @@ -22,7 +22,7 @@ Installation of Plone 6 Documentation includes prerequisites and the repository ```{include} ../../volto/_inc/_install-operating-system.md ``` -- {ref}`setup-build-installation-python-label` {{SUPPORTED_PYTHON_VERSIONS_PLONE62}} +- {ref}`setup-build-installation-python-label` {{SUPPORTED_PYTHON_VERSIONS_PLONE63}} - {ref}`setup-build-installation-gnu-make-label` - {ref}`setup-build-installation-graphviz-label` @@ -31,7 +31,7 @@ Installation of Plone 6 Documentation includes prerequisites and the repository ### Python -```{include} /_inc/_install-python-plone62.md +```{include} /_inc/_install-python-plone63.md ``` (setup-build-installation-gnu-make-label)= From fb7bbeda10b3a456888b3c1b1a887fa35ccafdb9 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Fri, 22 May 2026 14:46:22 -0700 Subject: [PATCH 2/3] - Add to 6.3 to toctree at upgrade/index --- docs/upgrade/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/upgrade/index.md b/docs/upgrade/index.md index 926155fd3b..9929a5ea80 100644 --- a/docs/upgrade/index.md +++ b/docs/upgrade/index.md @@ -19,6 +19,7 @@ Plone has several components, each of which have their own upgrade guides: For Plone 6 the most relevant guides are: +- {doc}`../backend/upgrading/version-specific-migration/upgrade-to-63` - {doc}`../backend/upgrading/version-specific-migration/upgrade-to-62` - {doc}`../backend/upgrading/version-specific-migration/upgrade-to-61` - {doc}`../backend/upgrading/version-specific-migration/upgrade-to-60` From f252e27822ff161121e191c9dff30a667b85c65d Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Fri, 22 May 2026 14:47:58 -0700 Subject: [PATCH 3/3] Revert, wrong branch --- docs/upgrade/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/upgrade/index.md b/docs/upgrade/index.md index 9929a5ea80..926155fd3b 100644 --- a/docs/upgrade/index.md +++ b/docs/upgrade/index.md @@ -19,7 +19,6 @@ Plone has several components, each of which have their own upgrade guides: For Plone 6 the most relevant guides are: -- {doc}`../backend/upgrading/version-specific-migration/upgrade-to-63` - {doc}`../backend/upgrading/version-specific-migration/upgrade-to-62` - {doc}`../backend/upgrading/version-specific-migration/upgrade-to-61` - {doc}`../backend/upgrading/version-specific-migration/upgrade-to-60`