Mailman 3 October 2019 - Doc-SIG

Status for Transifex-based translations
by Maciek Olko Aug. 1, 2021

Aug. 1, 2021

Hello, I want to share with you a small script that displays translation status for language switcher for Transifex-based translations. The script is using Transifex API [1] and requires Transifex API token. https://github.com/m-aciek/python-docs-pl-status/blob/master/checkstatus.py It generates README.md file with status. Currently, for Polish translation it is 5.17%. Regards, Maciej [1] https://docs.transifex.com/api/resources [2] https://github.com/m-aciek/python-docs-pl-status

3 6

Polish translation
by Maciek Olko Aug. 13, 2020

Aug. 13, 2020

Hello, I'd like to request a designation to coordinator role for Polish translation of Python documentation and a creation of GitHub repository for it. I am currently a Python developer at YouGov. I am coordinator of Django documentation translation into Polish. I am native Polish speaker, my English skills are about C2 CEFR [1]. In couple of days I'd like come up with a plan to efficiently encourage people to join the translation project. Regards, Maciej Olko [1] https://en.wikipedia.org/wiki/Common_European_Framework_of_Reference_for_La…

2 5

Python Documentation Translation to Bahasa Indonesia (Indonesian Language)
by oon arfiandwi Jan. 4, 2020

Jan. 4, 2020

Dear doc-sig members, hope this email finds you well. my name is oon arfiandwi, currently, I'm doing a sprint to translate Python Documentation to Bahasa Indonesia, and in the next few days, it will achieve the minimum requirement, which mentioned on PEP 545, to be able to add to Language Switcher. The translation synchronized between Transifex and my github repo [1]. I have several questions before I continue the process: a. according to devguide site [2], I need to finish `library/stdtypes` too, but it is not mentioned on (current PEP 545). can someone help me to clarify which one is the minimum? b. I saw on Python's github repo, many python-doc-{LANG} hosted there, how to request `python-doc-id` on that repository? c. Is it mandatory to have reviewer on Transifex? I saw not many languages doing reviews on the translation there. d. and what to do next, if I have completed the translations (a), to be included on language switcher? thank you for any help and explanation. [1]: https://github.com/oonid/python-docs-id [2]: https://devguide.python.org/documenting/#starting-a-new-translation -- sincerely, oon arfiandwi

3 12

Looking for language coordinators
by tomo cocoa Dec. 11, 2019

Dec. 11, 2019

Hello, all translators First of all, I like to celebrate the GA release of Python 3.8 and congratulate all members related to this release!! I send this email, because I want to share roles on the Transifex project. Currently, all join requests and adding languages requests are approved by me, because I am only the active member assigned roles necessary for approvement. This structure is come from a historical reason, but it is not practical now. I have no idea if I should approve this join request, so I always approve any join request. That is not a healthy way of community management. I suggest that each language groups should have at least two coordinators, who is responsible for overseeing a particular language within a team. For more details, see transifex documents: https://docs.transifex.com/teams/understanding-user-roles#language-coordina… If you have any comment, please let me know. Best regards, cocoatomo -- class Cocoatomo: name = 'cocoatomo' email_address = 'cocoatomo77(a)gmail.com' twitter_id = '@cocoatomo'

5 16

Re: [Doc-SIG] Looking for language coordinators (Russian)
by Kristina Mironova Nov. 3, 2019

Nov. 3, 2019

Hi, Tomo! I will be glad to be a coordinator for the Russian Language Team. As we translate documentation on transifex it's always a question for new participants whether they requests be approved or not and when. It will be more convenient to approve the join requests from our new translators within a Team. Absolutely support your idea to share the roles. Best regards, Kristina Mironova

2 3

Python standard library documentation flavors
by Eric Irrgang Oct. 14, 2019

Oct. 14, 2019

Hello, I am trying to understand the relationship between the Python standard library docstrings and the online documentation. For example, it does not appear that https://raw.githubusercontent.com/python/cpython/master/Doc/library/collect… is a strict superset of the docstrings in https://github.com/python/cpython/blob/master/Lib/collections/__init__.py and I do not see any indication that docstrings are automatically extracted anywhere, nor any comment as to why or why not. Is there a standing decision *not* to use, say, sphinx-apidoc or sphinx.ext.autodoc? If so, can you point me to an explanation of how the benefits of fully human-maintained documentation outweigh the convenience and consistency of automation? In other words, is this an affirmative policy decision that other projects should be guided by, or an accident of history with a lesson to be learned? Is there a document that clarifies the role of the standard library docstrings, and what belongs there versus in cpython/Doc/library? Maybe there is a PEP I haven't noticed? I hope my question is not too open-ended for this list, but I would also welcome replies off list. Thank you for your time, Eric

2 1