Skip to content

Commit acdfd0a

Browse files
Hugo's Review
1 parent 9960fd3 commit acdfd0a

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

documentation/translations/coordinating.rst

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -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

1414
Discussions about translations occur on the Python Docs Discord
@@ -22,11 +22,10 @@ For administrative issues, ping ``@python/editorial-board``.
2222
Starting 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
2626
you start your translation, carefully consider if you will be able to commit
2727
to 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

3130
The following sections will guide you through setting up your translation.
3231
If 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
3635
Announcement
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

4443
Coordination 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

6363
Gather 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
6565
your translation easier to find. In the entry you can also include links to
6666
guides or other resources for translators.
6767

6868

6969
Repository
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
7474
in several ways, and will dictate the translation process you use.
7575

7676
The branch name should be the version, for example, ``3.14``, and the files
7777
should 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

8484
Then you can bootstrap your new translation by using the `cookiecutter

0 commit comments

Comments
 (0)