Doc-SIG

Download

doc-sig@python.org

November 2018

2 participants
2 discussions

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