Skip to content

Notas migración #2731

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Dec 23, 2023
Merged

Notas migración #2731

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
99fb90e
Actualization de notas de migración (parte 1)
aandrea Nov 3, 2023
aae5978
Complete instructions for upgrade and update version in github action…
aandrea Nov 3, 2023
e120332
Update .overrides/upgrade-python-version.rst
aandrea Nov 4, 2023
77cf439
Merge branch '3.12' into notas-migracion
cacrespo Nov 15, 2023
8a7ac28
Apply suggestions from code review
mmmarcos Dec 23, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .overrides/faq.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -204,9 +204,9 @@ repositorio principal de la traducción). Se hace de la siguiente manera::

Luego nos vamos a nuestra rama local, confirmamos e impactamos esos cambios::

git checkout 3.11
git merge upstream/3.11
git push origin 3.11
git checkout 3.12
git merge upstream/3.12
git push origin 3.12

¡Eso es todo!

Expand Down
2 changes: 1 addition & 1 deletion .overrides/progress.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ y otras estadísticas.

.. note::

Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.11``.
Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.12``.


En progreso
Expand Down
30 changes: 18 additions & 12 deletions .overrides/upgrade-python-version.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,12 @@ We are currently in branch 3.11, and we want to update the strings from 3.12.
.. note:: This is important, so the later ``make build`` step will not reset
the cpython submodule to the previous hash on the old branch.

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

python -m venv env
source env/bin/activate # Windows: env\Scripts\activate.bat
pip install -r requirements.txt

#. Verify that the docs build with the new versions you changed from
``requirements.txt`` mainly the sphinx version::

Expand All @@ -53,21 +59,14 @@ We are currently in branch 3.11, and we want to update the strings from 3.12.

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

rm -rf _build ../python-docs-es-pot cpython/Doc/CONTRIBUTING.rst cpython/Doc/upgrade-python-version.rst
rm -rf _build ../python-docs-es-pot cpython/Doc/CONTRIBUTING.rst cpython/Doc/upgrade-python-version.rst reviewers-guide.rst

.. note::

The 'python-docs-es-pot' is a temporary directory that is created
in the next step. It's included here because it might be a leftover
from previous attempts on your machine.

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

python -m venv env
source env/bin/activate # Windows: env\Scripts\activate.bat
pip install -r requirements.txt


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

SPHINX_GETTEXT=True sphinx-build -j auto -b gettext -d _build/doctrees . ../python-docs-es-pot
Expand Down Expand Up @@ -114,9 +113,16 @@ We are currently in branch 3.11, and we want to update the strings from 3.12.
of the new branch is done. So prepare a cup of any hot beverage
and fix them.

Once the process is completely and you are happy with the results,
there are a few extra steps to finish the process::
**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.12, by updating Python version to 3.12 in the ``.github/workflows/main.yml`` file.

#. Upgrade GitHub Actions to use Python 3.12
#. Update the *Read the Docs* project to use 3.12 in the build and also as default branch/version.

#. Commit all the newly created files locally.

#. Create branch 3.12 in the repository in order to merge changes there.

#. Inside the github project settings, set 3.12 branch as the default branch for the repository.

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