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:[email protected]>`__) | ||
| - :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?
There was a problem hiding this comment.
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?
| - `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"
| The documentation is full of technical terms, some are common in general | ||
| programming and have translations, whereas others are specific to Python | ||
| and previous translations are not available (remember to check your languages | ||
| glossary). Translations should keep the translations of these terms consistent, |
There was a problem hiding this comment.
Did you mean "translators" in here?
| glossary). Translations should keep the translations of these terms consistent, | |
| glossary). Translators should keep the translations of these terms consistent, |
There was a problem hiding this comment.
No, though I see I'm getting a bit repetitive ("translat*" is every fifth word...). I meant that each translation team should have a glossary.
|
|
||
| .. important:: | ||
|
|
||
| There are many translations in the `python-doc organization on transifex <tx_>`_, |
There was a problem hiding this comment.
| There are many translations in the `python-doc organization on transifex <tx_>`_, | |
| There are many translations in the `python-doc organization on Transifex <tx_>`_, |
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