docs: add update instructions for new major Python releases

diff --git a/docs/release.rst b/docs/release.rst
index a08b4337f89646baa1b178f29eb50650e0fc0625..8a8c4c677b9d85b9021957b21ebadd997bacd32e 100644 (file)
--- a/docs/release.rst
+++ b/docs/release.rst
@@ -87,3 +87,19 @@ When a new PostgreSQL major version is released
 
   - ``docs/basic/install.rst``;
   - ``content/features/contents.lr`` in the psycopg-website repository.
+
+When a new Python major version is released
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Add the new version to the relevant test matrices in
+  ``.github/workflows/tests.yml`` and ``.github/workflows/packages-bin.yml``.
+
+- Update ``docs/basic/install.rst`` with the correct range of supported Python
+  versions.
+
+- Add the ``Programming Language :: Python :: 3.<X>`` classifier to
+  ``psycopg/setup.cfg``, ``psycopg_c/setup.cfg`` and ``psycopg_pool/setup.cfg``.
+
+- Update the list of versions in ``tools/build/build_macos_arm64.sh`` to include
+  the new version. Look for both the ``python_versions`` variable and the
+  ``CIBW_BUILD`` environment variable.