.potodo/

#. Make sure you are in a clean state of the branch 3.10

#. Create a new branch

#. Create a new branch called ``3.11``

#. Fetch the `latest commit of 3.10 branch<https://github.com/python/cpython/commit/69b6b56d857440183e227ca0b10c84bca4239985>`_::

#. Initialize the submodules::

#. Fetch the `latest commit of 3.11 branch<https://github.com/python/cpython/commit/b3cafb60afeb2300002af9982d43703435b8302d>`_::

#. Checkout that commit locally::

#. Update the branch on the `Makefile` and check the `requirements.txt` from

#. Update the branch on the ``Makefile`` and check the ``requirements.txt`` from

the cpython repository, to see if upgrades on the modules like sphinx is

needed.

#. Verify that the docs build with the new versions you changed from

`requirements.txt` mainly the sphinx version.

#. Commit the update of the submodule change::

#. Verify that the docs build with the new versions you changed from

``requirements.txt`` mainly the sphinx version::

..note::

It may fail the build because there may be files

that don't exist anymore in the new branch.

If that's the case, just continue with the steps

and verify the build later.

#. Clean possible garbage (form previous builds)::

#. Create a virtual environment and install the dependencies of the project::

#. Create the .po files from the new source code. This will generate all the .po files for version 3.8::

#. Create the .po files from the new source code. This will generate all the .po files for version 3.11::

#. Now, we update our translated files form the source language (English) with new strings::

#. At this point, all the `.po` files will have a different comment on each translation phrase,

#. At this point, all the ``.po`` files will have a different comment on each translation phrase,

for example::

As you can see, it added the path of the local repository, but you can

remove it from it with this regular expression::

..note:: if you have your local repository cloned with a different name,

please make sure to adapt the expression.

..note::

If you have your local repository cloned with a different name,

please make sure to adapt the expression.

#. Pass `powrap` to make the column widths consistent::

#. Pass ``powrap`` to make the column widths consistent::

#. Prepare for fireworks! Now it's time for an initial build::

Once the process is completely and you are happy with the results,

there are a few extra steps to finish the process::

#. Upgrade GitHub Actions to use Python 3.11

#. Update Read the Docs project to use 3.11 in the build and also as default branch/version