@@ -8,7 +8,7 @@ found on this page and in :PEP:`545`. Translations are overseen by the
88
99.. _translation-help :
1010
11- Communication/Help channels
11+ Communication/help channels
1212===========================
1313
1414Discussions about translations occur on the Python Docs Discord
@@ -22,11 +22,10 @@ For administrative issues, ping ``@python/editorial-board``.
2222Starting a new translation
2323==========================
2424
25- Coordination is not a once -off task, it is a long term commitment. Before
25+ Coordination is not a one -off task, it is a long- term commitment. Before
2626you start your translation, carefully consider if you will be able to commit
2727to this.
28- Every coordinator should be familiar with translating, for this you should see
29- :ref: `translating `.
28+ Every coordinator should be familiar with translating: see :ref: `translating `.
3029
3130The following sections will guide you through setting up your translation.
3231If you have any questions or need help, ask in one of the
@@ -36,9 +35,9 @@ If you have any questions or need help, ask in one of the
3635Announcement
3736------------
3837
39- You should post an announcement introducing yourself and the translation you're
40- starting on `Discourse <trans_disc >`_. You should also join the other communication
41- channels if possible.
38+ Post an announcement introducing yourself and the translation you're
39+ starting on `Discourse <trans_disc >`_. Also join the other communication
40+ channels, if possible.
4241
4342
4443Coordination team
@@ -57,28 +56,29 @@ Translation team
5756.. figure :: translator-workload.svg
5857 :class: invert-in-dark-mode
5958 :align: center
60- :alt: Translator workload chart
59+ :alt: An exaggerated chart showing that individual translator workload
60+ decreases with the amount of translators.
6161
6262
6363Gather people to help you translate. You can't do it alone.
64- You should update :ref: `this table <translation-coordinators >` via a PR to make
64+ Update :ref: `this table <translation-coordinators >` via a PR to make
6565your translation easier to find. In the entry you can also include links to
6666guides or other resources for translators.
6767
6868
6969Repository
7070----------
7171
72- To start your translation you should create a GitHub repository, under any
73- account, with the correct git hierarchy and folder structure. This can be done
72+ To start your translation create a GitHub repository, under any
73+ account, with the correct Git hierarchy and folder structure. This can be done
7474in several ways, and will dictate the translation process you use.
7575
7676The branch name should be the version, for example, ``3.14 ``, and the files
7777should be structured like the source files in `CPython/Doc <https://github.com/python/cpython/tree/main/Doc >`_.
78- A correctly set up repository should look like this: `python-docs-pl <https://github.com/python/python-docs-pl/ >`_
78+ A correctly set up repository looks like this: `python-docs-pl <https://github.com/python/python-docs-pl/ >`_
7979
8080
81- Cookiecutter/Bootstrapper
81+ Cookiecutter/bootstrapper
8282~~~~~~~~~~~~~~~~~~~~~~~~~
8383
8484Then you can bootstrap your new translation by using the `cookiecutter
0 commit comments