pyOpenSci / python-package-guide

Scientific Python package recommendations & guidance curated by pyOpenSci
https://www.pyopensci.org/python-package-guide/
Other
98 stars 52 forks source link

Improving accessibility for translators using Transifex etc #358

Open tkoyama010 opened 2 months ago

tkoyama010 commented 2 months ago

The translation of this repository assumes that you are using GitHub to edit po files. https://github.com/pyOpenSci/python-package-guide/blob/0786310017fce7123baa2f22942436713b866229/TRANSLATING.md?plain=1#L142-L144

However, as described in [PEP 545 - Python Documentation Translations

[!NOTE] If the size of the translation project is as small as it is now, we are not in a hurry to solve this problem, as it is sufficient as it is now.

flpm commented 2 months ago

Transifex and other similar sites can be handy in some projects, but it did not feel like a fit for PyOpenSci.

Note: for someone not familiar, Transifex is a TMS (Translation Management System), a site that manages your translation files for you and serve as interface for the translators so they don't need to interact with git or GitHub.

One of the goals of PyOpenSci is education, automating the translation contribution felt like missing a great opportunity to provide people new to open source an easy way to learn how to use git and GiHub and go through the open source contribution cycle.

Using Transifex also has the downside of the contributor not getting GitHub credit since Transifex is the one making the PR, which denies a bit the "reward" and the satisfaction of seeing your first contribution.

But as you said, there are many pros and cons and we can always consider the "cost" of maintenance versus the education side, at some point it may make sense to change course.

tkoyama010 commented 2 months ago

+100 Thanks.