Update `translation/translators.rst` #1576

StanFromIreland · 2025-06-16T12:28:28Z

This is a very rough draft that has been opened for the purpose of asking some questions and is subject to a lot of change, some of which I have already done locally.

There are some small changes to coordinating.rst in this pull request which came up as I was working on this.

cc @willingc

📚 Documentation preview 📚: https://cpython-devguide--1576.org.readthedocs.build/documentation/translations

StanFromIreland · 2025-06-16T12:31:11Z

documentation/translations/translating.rst

+
+.. _translation-coordinators:
+
+.. XXX Add explicit links to README/CONTRIBUTING?


I think it would be nice, it will make it easier for people to start contributing though it will expand the already large table.

StanFromIreland · 2025-06-16T12:31:54Z

documentation/translations/translating.rst

+     - `AFPy/python-docs-fr <https://git.afpy.org/AFPy/python-docs-fr/>`_
+       :github:`Mirror <python/python-docs-fr>`


cc @JulienPalard Is this correct, it is what I gathered from the repositories though it is in French so I may be wrong?

This is correct. French translation happens at AFPy's Gitea and are simply mirrored to GitHub.

Instead of "GitHub" or "AFPy", there could be "repo" or "repository" text which links to the proper translation repository (for all rows in the table). Please add a comma before "Mirror"

StanFromIreland · 2025-06-16T12:34:02Z

documentation/translations/translating.rst

-     - :github:`GitHub <CuriousLearner/python-docs-hi-in>`
-   * - Hungarian (hu)
+     - :github:`GitHub <CuriousLearner/python-docs-hi-in>` XXX Message user in issue tracker https://github.com/CuriousLearner/python-docs-hi-in/issues/5
+   * - `Hungarian (hu) <https://docs.python.org/hu/>`__ XXX This should probably be added


EB/@gbtami, do we want to add Hungarian to docsbuild-scripts since it is already under the python org?

StanFromIreland · 2025-06-16T12:35:14Z

documentation/translations/translating.rst

     - Alessandro Cucci (`email <mailto:alessandro.cucci@gmail.com>`__)
     - :github:`GitHub <python/python-docs-it>`,
-       `original mail <https://mail.python.org/pipermail/doc-sig/2019-April/004114.html>`__
+       `Original announcement <https://mail.python.org/pipermail/doc-sig/2019-April/004114.html>`__


Note: I chose this since it is more self explanatory, and we can use the same term if an announcement is made on Discourse instead.

documentation/translations/translating.rst

StanFromIreland · 2025-06-16T12:51:16Z

documentation/translations/translating.rst



 Translation FAQ
 ===============

-Which version of the Python documentation should be translated?
---------------------------------------------------------------
+Which version of the Python documentation should I work on?


I updated this to be more translator focused and moved the old one to coordinating.

StanFromIreland · 2025-06-16T12:52:00Z

documentation/translations/translating.rst

+:doc:`coordinating` and open an issue in the
+`EB issue tracker <https://github.com/python/editorial-board/issues>`_.
+
+.. XXX Ask EB if this is ok


EB, are these steps correct?

I would have them open an issue on the Dev Guide requesting to be added to the translation chart. I think it is fine to have the person @-mention the EB @editorial-board in the devguide issue to review the PR. I don't think we need a PR on the editorial board repo each time. Thoughts, @nedbat?

StanFromIreland · 2025-06-16T12:53:00Z

documentation/translations/coordinating.rst

 Starting a new translation
 ==========================

 First subscribe to the `translation mailing list <translation_ml_>`_,
 and introduce yourself and the translation you're starting. Translations
 fall under the aegis of the `PSF Translation Workgroup <translation_wg_>`_

+.. https://github.com/python/editorial-board/issues/32


Requested clarification for Translation WG: python/editorial-board#32

StanFromIreland · 2025-06-16T12:53:47Z

documentation/translations/coordinating.rst


 Ask on the `translation mailing list <translation_ml_>`_, or better, make a PR on the `devguide
 <https://github.com/python/devguide/>`__.

+
+Is there a Weblate instance we can translate on?


@m-aciek how does this look to you?

documentation/translations/coordinating.rst

rffontenelle · 2025-06-16T16:40:22Z

documentation/translations/translating.rst

+     - `AFPy/python-docs-fr <https://git.afpy.org/AFPy/python-docs-fr/>`_
+       :github:`Mirror <python/python-docs-fr>`


This is correct. French translation happens at AFPy's Gitea and are simply mirrored to GitHub.

Instead of "GitHub" or "AFPy", there could be "repo" or "repository" text which links to the proper translation repository (for all rows in the table). Please add a comma before "Mirror"

documentation/translations/translating.rst

rffontenelle · 2025-06-16T16:45:38Z

documentation/translations/translating.rst

+mailing list <translation_ml_>`_, and the `translations subsection <_discourse>`_
+of the Python Discourse.


Since some may not use a proprietary tool like Discourse, maybe keeping a instant messaging room would be interesting. But I'd suggest to migrate to Matrix instead of Libera Chat considering that there is no bridge between them anymore, and Matrix has great adoption.

documentation/translations/translating.rst

m-aciek · 2025-06-16T22:15:54Z

documentation/translations/coordinating.rst

+There is currently no Weblate instance for use by Python translations because of
+certain limitations, these include word count limits and organization of
+translation source.


Suggested change

There is currently no Weblate instance for use by Python translations because of

certain limitations, these include word count limits and organization of

translation source.

`There is currently no Weblate instance for use by Python translations at the moment. <https://discuss.python.org/t/docs-translation-platform/29940>`__

nedbat · 2025-06-16T23:52:58Z

core-developers/experts.rst

@@ -372,4 +372,7 @@ version control     merwok, ezio-melotti
 Documentation translations
 ==========================

-For a list of translators, see :ref:`this table about translations <translating>`.
+Translations fall under the aegis of the


"aegis" is esoteric. How about "Translations are within the charter of..."

nedbat · 2025-06-16T23:53:54Z

documentation/translations/coordinating.rst

@@ -73,7 +95,8 @@ __ https://github.com/python-docs-translations
 How is a coordinator elected?
 -----------------------------

-There is no election. Each translation will sort out the number of coordinators. We recommend 2 or 3 coordinators, though you may begin with one.  Here are some general suggestions.
+There is no election. Each translation will sort out the number of coordinators.


Instead of "sort out", how about "Each translation team will decide on the number of coordinators."

nedbat · 2025-06-16T23:54:19Z

documentation/translations/coordinating.rst

@@ -73,7 +95,8 @@ __ https://github.com/python-docs-translations
 How is a coordinator elected?
 -----------------------------

-There is no election. Each translation will sort out the number of coordinators. We recommend 2 or 3 coordinators, though you may begin with one.  Here are some general suggestions.
+There is no election. Each translation will sort out the number of coordinators.
+We recommend 2 or 3 coordinators, though you may begin with one.  Here are some general suggestions.


Numbers less than ten should be spelled out. "two or three coordinators"

nedbat · 2025-06-16T23:55:10Z

documentation/translations/translating.rst

-details.
+There are several documentation translations already
+in production; others are works in progress. To get started read your
+repositories contributing guide, which is generally the ``README``


Suggested change

repositories contributing guide, which is generally the ``README``

repository's contributing guide, which is generally the ``README``

nedbat · 2025-06-16T23:56:21Z

documentation/translations/translating.rst

-Discussions about translations occur on the Python Docs Discord
+If there is already a repository for your language team (there may be links to
+Telegrams/Discords in the ``README``), join and introduce
+yourself, your fellow translators will be more than happy to help! XXX sounds off


Suggested change

yourself, your fellow translators will be more than happy to help! XXX sounds off

yourself. Your fellow translators will be more than happy to help!

nedbat · 2025-06-16T23:59:16Z

documentation/translations/translating.rst

+===========
+
+Before translating, you should familiarize yourself with the general
+documentation :doc:`style guide<../style-guide>`. Some translation specific


Suggested change

documentation :doc:`style guide<../style-guide>`. Some translation specific

documentation :doc:`style guide<../style-guide>`. Some translation-specific

willingc · 2025-06-16T18:53:44Z

documentation/translations/coordinating.rst

+translation from one branch to another using :pypi:`pomerge`.
+
+
+The entry for my translation is missing/not up to date


Suggested change

The entry for my translation is missing/not up to date

The entry for my translation is missing or out of date.

willingc · 2025-06-16T19:02:47Z

documentation/translations/coordinating.rst

@@ -2,12 +2,17 @@
 Coordinating
 ============

+Python documentation translations are governed by :PEP:`545`.


Suggested change

Python documentation translations are governed by :PEP:`545`.

Current information about the Python documentation translation processes is found in this devguide, and Process :PEP:`545`, adopted in 2018.

willingc · 2025-06-17T02:56:01Z

documentation/translations/coordinating.rst

+Which version of the Python documentation should be translated?
+---------------------------------------------------------------
+
+Consensus is to work on the current stable version. You can then propagate your


Suggested change

Consensus is to work on the current stable version. You can then propagate your

It's best to work on Python's current stable version. You can then propagate your

Initial

9ca670a

StanFromIreland commented Jun 16, 2025

View reviewed changes

rffontenelle suggested changes Jun 16, 2025

View reviewed changes

Rafael's feedback

8960469

m-aciek suggested changes Jun 16, 2025

View reviewed changes

nedbat reviewed Jun 16, 2025

View reviewed changes

willingc reviewed Jun 17, 2025

View reviewed changes


		.. _translation-coordinators:

		.. XXX Add explicit links to README/CONTRIBUTING?

		- `AFPy/python-docs-fr <https://git.afpy.org/AFPy/python-docs-fr/>`_
		:github:`Mirror <python/python-docs-fr>`

		mailing list <translation_ml_>`_, and the `translations subsection <_discourse>`_
		of the Python Discourse.

	repositories contributing guide, which is generally the ``README``
	repository's contributing guide, which is generally the ``README``

	yourself, your fellow translators will be more than happy to help! XXX sounds off
	yourself. Your fellow translators will be more than happy to help!

	documentation :doc:`style guide<../style-guide>`. Some translation specific
	documentation :doc:`style guide<../style-guide>`. Some translation-specific

		translation from one branch to another using :pypi:`pomerge`.


		The entry for my translation is missing/not up to date

	The entry for my translation is missing/not up to date
	The entry for my translation is missing or out of date.

	Python documentation translations are governed by :PEP:`545`.
	Current information about the Python documentation translation processes is found in this devguide, and Process :PEP:`545`, adopted in 2018.

	Consensus is to work on the current stable version. You can then propagate your
	It's best to work on Python's current stable version. You can then propagate your

Uh oh!

Update translation/translators.rst #1576

Are you sure you want to change the base?

Update translation/translators.rst #1576

Conversation

StanFromIreland commented Jun 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

willingc Jun 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

willingc Jun 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Update `translation/translators.rst` #1576

Update `translation/translators.rst` #1576

StanFromIreland commented Jun 16, 2025 •

edited

Loading

willingc Jun 16, 2025 •

edited

Loading

willingc Jun 16, 2025 •

edited

Loading