Update translation/translators.rst
#1576
Conversation
|
|
||
| .. _translation-coordinators: | ||
|
|
||
| .. XXX Add explicit links to README/CONTRIBUTING? |
There was a problem hiding this comment.
I think it would be nice, it will make it easier for people to start contributing though it will expand the already large table.
| - `AFPy/python-docs-fr <https://git.afpy.org/AFPy/python-docs-fr/>`_ | ||
| :github:`Mirror <python/python-docs-fr>` |
There was a problem hiding this comment.
cc @JulienPalard Is this correct, it is what I gathered from the repositories though it is in French so I may be wrong?
There was a problem hiding this comment.
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"
| - :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 |
There was a problem hiding this comment.
EB/@gbtami, do we want to add Hungarian to docsbuild-scripts since it is already under the python org?
| - 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>`__ |
There was a problem hiding this comment.
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.
| Translation FAQ | ||
| =============== | ||
|
|
||
| Which version of the Python documentation should be translated? | ||
| --------------------------------------------------------------- | ||
| Which version of the Python documentation should I work on? |
There was a problem hiding this comment.
I updated this to be more translator focused and moved the old one to coordinating.
| :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 |
There was a problem hiding this comment.
EB, are these steps correct?
| 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 |
There was a problem hiding this comment.
Requested clarification for Translation WG: python/editorial-board#32
|
|
||
| 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? |
There was a problem hiding this comment.
@m-aciek how does this look to you?
| - `AFPy/python-docs-fr <https://git.afpy.org/AFPy/python-docs-fr/>`_ | ||
| :github:`Mirror <python/python-docs-fr>` |
There was a problem hiding this comment.
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"
| mailing list <translation_ml_>`_, and the `translations subsection <_discourse>`_ | ||
| of the Python Discourse. |
There was a problem hiding this comment.
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.
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.rstin 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