Mailman 3 January 2021 - 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

Russian Docs Translation
by Kristina Mironova Jan. 25, 2021

Jan. 25, 2021

Hello Julien. Maksim joined us with full Python 3.8.3 documentation translated. You can see translation on his site https://digitology.tech/docs/python_3/ Can you please create python/python-docs-ru? Best regards, Kristina Mironova

4 5

File 0 on Transifex
by oon arfiandwi Jan. 22, 2021

Jan. 22, 2021

Dear Doc SIG members, cocoatomo, hope all of you are well. I need help with Transifex, I got a notification on Nov 3 that new file 0 has been added to project Python. Since then, every day I just got a notification about this file 0, but no other files getting updates from the main documentation. Does anyone know how to fix this? thank you for your help. -- sincerely, oon arfiandwi

3 5

PEP 257
by Paul Graves-DesLauriers Jan. 4, 2021

Jan. 4, 2021

I would like clarification about the one-line docstring <https://www.python.org/dev/peps/pep-0257/#id16> example. The Notes say (fourth bullet): The docstring is a phrase ending in a period. It prescribes the function or method's effect as a command ("Do this", "Return that"), not as a description; e.g. don't write "Returns the pathname ...". However the docstring example for kos_root() is: """Return the pathname of the KOS root directory.""" I've highlighted the areas that seem to contradict each other. Perhaps the example should be updated to conform to the notes? Thanks, Paul

2 1