Skip to content

Commit b432562

Browse files
Wrap lines to ~80 chars (#145)
1 parent 7c94029 commit b432562

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

docs/bumping-release.rst

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,24 +2,29 @@
22
Bumping python-newest to latest Python release
33
====================================================
44

5-
NOTE: This doc is out of date and needs rework! The `pull request \#13 <https://github.com/python-docs-translations/transifex-automations/pull/13>`_ is a work in progress that would change some instructions from this guide.
5+
NOTE: This doc is out of date and needs rework! The
6+
`pull request \#13 <https://github.com/python-docs-translations/transifex-automations/pull/13>`_
7+
is a work in progress that would change some instructions from this guide.
68

7-
This document aims to list the steps required for updating version of the 'Python' project (slug 'python-newest) in python-doc organization in Transifex.
9+
This document aims to list the steps required for updating version of the 'Python'
10+
project (slug 'python-newest) in python-doc organization in Transifex.
811

912
1. Back up current translations:
1013

1114
#. Run ``sh scripts/update.sh`` to set up the environment, if not done already;
1215
#. Run ``python3 scripts/getlangs.py`` to get a list of all languages;
1316
#. Change to ``cpython/Doc/locales`` directory; and
14-
#. Run ``tx pull --languages <LANGUAGES>`` to download translations from Transifex, replacing ``<LANGUAGES>`` with the output of step 1.2.
17+
#. Run ``tx pull --languages <LANGUAGES>`` to download translations from Transifex,
18+
replacing ``<LANGUAGES>`` with the output of step 1.2.
1519

1620
2. Post a Python version upgrade announcement
1721

1822
3. (How?) Lock all resources in python-newest for all languages
1923

2024
#. Take note of the last change in timeline and its timestamp: *Python* > *Settings* > *Timeline*.
2125

22-
4. Create a Transifex project with versioned name to receive python-newest's translations, setting it with the following values:
26+
4. Create a Transifex project with versioned name to receive python-newest's
27+
translations, setting it with the following values:
2328

2429
:*Name your project*: Python <version> (e.g. Python 3.10)
2530
:*URL to opensource license*: https://github.com/python/cpython
@@ -38,19 +43,25 @@ In *General* tab:
3843

3944
In *Workflow* tab, enable the *Translation Memory Fillup* option by checking the checkbox;
4045

41-
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.
46+
NOTE: The *Translation Memory Fillup* option is essential to have a translation
47+
in one of the version projects to be populated to this project. This drastically
48+
reduces translation effort replicating one contribution to other strings that are
49+
exactly the same.
4250

4351
6. Adjust the `CI workflow <https://github.com/python-docs-translations/transifex-automations/tree/main/.github/workflows>`_ with the new Python version:
4452

4553
#. Set ``PYTHON_NEWEST`` environment variable inside ``env`` to the new Python version
4654
#. Edit ``cpython_version`` inside ``strategy.matrix`` adding the new version to the beginning array
4755

48-
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"
56+
7. Push source strings to python-newest by manually running the CI workflow:
57+
Actions_ tab > CI > Run workflow button > "Branch: main" and confirm "Run workflow"
4958

5059
.. _Actions: https://github.com/python-docs-translations/transifex-automations/actions
5160

5261
8. Unlock translations in python-newest, if locked
5362

54-
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")
63+
9. Double-check resources in python-newest. New resources are named after their
64+
pot files (e.g. "3.11.pot"), and they should be renamed to match their slug (e.g. "whatsnew--3_11")
5565

56-
10. Announce that the maintenance is over, and that python-newest is now using new Python version
66+
10. Announce that the maintenance is over, and that python-newest is now using
67+
new Python version

0 commit comments

Comments
 (0)