From d34962af11164ae2e6e207a760f076d18b7a312b Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Mon, 9 Jun 2025 16:59:44 +0100 Subject: [PATCH] Wrap lines to ~80 chars --- docs/bumping-release.rst | 27 +++++++++++++++++++-------- 1 file changed, 19 insertions(+), 8 deletions(-) diff --git a/docs/bumping-release.rst b/docs/bumping-release.rst index 9381f4edd2c..f49d094c0b3 100644 --- a/docs/bumping-release.rst +++ b/docs/bumping-release.rst @@ -2,16 +2,20 @@ Bumping python-newest to latest Python release ==================================================== -NOTE: This doc is out of date and needs rework! The `pull request \#13 `_ is a work in progress that would change some instructions from this guide. +NOTE: This doc is out of date and needs rework! The +`pull request \#13 `_ +is a work in progress that would change some instructions from this guide. -This document aims to list the steps required for updating version of the 'Python' project (slug 'python-newest) in python-doc organization in Transifex. +This document aims to list the steps required for updating version of the 'Python' +project (slug 'python-newest) in python-doc organization in Transifex. 1. Back up current translations: #. Run ``sh scripts/update.sh`` to set up the environment, if not done already; #. Run ``python3 scripts/getlangs.py`` to get a list of all languages; #. Change to ``cpython/Doc/locales`` directory; and - #. Run ``tx pull --languages `` to download translations from Transifex, replacing ```` with the output of step 1.2. + #. Run ``tx pull --languages `` to download translations from Transifex, + replacing ```` with the output of step 1.2. 2. Post a Python version upgrade announcement @@ -19,7 +23,8 @@ This document aims to list the steps required for updating version of the 'Pytho #. Take note of the last change in timeline and its timestamp: *Python* > *Settings* > *Timeline*. -4. Create a Transifex project with versioned name to receive python-newest's translations, setting it with the following values: +4. Create a Transifex project with versioned name to receive python-newest's + translations, setting it with the following values: :*Name your project*: Python (e.g. Python 3.10) :*URL to opensource license*: https://github.com/python/cpython @@ -38,19 +43,25 @@ In *General* tab: In *Workflow* tab, enable the *Translation Memory Fillup* option by checking the checkbox; - NOTE: The *Translation Memory Fillup* option is essential to have a translation in one of the version projects to be populated to this project. This drastically reduces translation effort replicating one contribution to other strings that are exactly the same. +NOTE: The *Translation Memory Fillup* option is essential to have a translation +in one of the version projects to be populated to this project. This drastically +reduces translation effort replicating one contribution to other strings that are +exactly the same. 6. Adjust the `CI workflow `_ with the new Python version: #. Set ``PYTHON_NEWEST`` environment variable inside ``env`` to the new Python version #. Edit ``cpython_version`` inside ``strategy.matrix`` adding the new version to the beginning array -7. Push source strings to python-newest by manually running the CI workflow: Actions_ tab > CI > Run workflow button > "Branch: main" and confirm "Run workflow" +7. Push source strings to python-newest by manually running the CI workflow: + Actions_ tab > CI > Run workflow button > "Branch: main" and confirm "Run workflow" .. _Actions: https://github.com/python-docs-translations/transifex-automations/actions 8. Unlock translations in python-newest, if locked -9. Double-check resources in python-newest. New resources are named after their pot files (e.g. "3.11.pot"), and they should be renamed to match their slug (e.g. "whatsnew--3_11") +9. Double-check resources in python-newest. New resources are named after their + pot files (e.g. "3.11.pot"), and they should be renamed to match their slug (e.g. "whatsnew--3_11") -10. Announce that the maintenance is over, and that python-newest is now using new Python version +10. Announce that the maintenance is over, and that python-newest is now using + new Python version