Mailman 3 October 2018 - Doc-SIG

About smart-quotes in translations
by Adrian Liaw Nov. 5, 2018

Nov. 5, 2018

Hi, Recently the zh-tw translations ran into a smart-quotes problem that I believe experienced by the Japanese team as well [1]. We're experiencing a similar problem [2], but here in our generated html the quotes not only are transformed into Chinese quotes automatically, but are also mismatching [3] where they should be pairs of 「 and 」. I also found out that the problem was fixed in GH-4006 [4] for Japanese translations, I suggest that we should have the same fix for zh-tw, perhaps zh-cn team would also want to do the same thing. [1] https://github.com/python/docsbuild-scripts/issues/32 [2] https://github.com/python/python-docs-zh-tw/pull/17#issuecomment-413134563 [3] https://python-doc-tw.github.io/tutorial/venv.html#managing-packages-with-p… , see the sentence "pip 有好幾個子指令：」search」、」install」、」uninstall」、」freeze」等等。（這可以參考安裝 Python 模組說明書來取得 pip 的完整文件說明。）" [4] https://github.com/python/cpython/pull/4006 Best Regards, Adrian Liaw -- Wey-Han "Adrian" Liaw (@adrianliaw2000) https://linkedin.com/in/adrianliaw https://github.com/adrianliaw

3 7

Translation License and Contribution Agreement
by Shengjing Zhu Nov. 1, 2018

Nov. 1, 2018

Hi, We just had a sync up meeting inside zh_CN team. Here're some questions about the Documentation Contribution Agreement. 1. In PEP545, it states we should "Setup the Documentation Contribution Agreement". I see most translation repo has a REAME with the example text in PEP. However what's the license for the translation is unclear to me. The example text says the license is CC0. But the po files fetched from transifex say "This file is distributed under the same license as the Python package." For team using transifex, I think most of us didn't aware it. 2. How can we guarantee the contributor has agreed? https://www.python.org/dev/peps/pep-0545/#id89 says "The Documentation Contribution Agreement have to be written by the PSF, then listed at https://www.python.org/psf/contrib/ and have its own page like https://www.python.org/psf/contrib/doc-contrib-form/." I think such form is not available yet. 3. Last question is for zh_CN team. We have previous work done on transifex before a README with Documentation Contribution Agreement. How can we handle such work? Is there a way to get a list of contributors on transifex(not the person who just joins the team)? And the way to known what they have translated, in case that they don't agree when we ask so that we can revert their work. -- Shengjing Zhu

2 2

Coordinate zh_CN Translation
by Shengjing Zhu Oct. 23, 2018

Oct. 23, 2018

Hi, I would like to get the zh_CN translation work organized. Since I last call for participation in CPyUG mailing-list[1], we now have few people interested. And some work already happens on transifex. The translation coverage really improved a lot last few months. So I'd like to 1. Create the python-docs-zh-cn repo. Maybe my personal repo zhsj/python-docs-zh-cn can just migrate to it. My transifex sync script can also continue to work. 2. We need more reviewers on transifex zh-CN team[2]. I'd like to be one first. And I hope I can have privilege to accept new member join request, since I get feedback that some people get long delay when they request to join. I may not have sufficient time to do the coordinating work, but I also didn't see others want to take the job. So I would say I'll do my best currently. But if others can help, we can work together. [1] https://groups.google.com/forum/#!topic/python-cn/8H4qhhI6khw [2] https://www.transifex.com/python-doc/teams/5390/zh_CN/ -- Shengjing Zhu

3 7