pyOpenSci / python-package-guide

scientific Python package recommendations & guidance curated by pyOpenSci
https://www.pyopensci.org/python-package-guide/
Other
93 stars 51 forks source link

Unclear how to translate references to files like LICENSE or CODE_OF_CONDUCT #330

Closed ncclementi closed 3 weeks ago

ncclementi commented 1 month ago

When translating to Spanish for example, there are some cases where you'll see something like this

#: ../../tutorials/add-license-coc.md:1
msgid "Add a `LICENSE` & `CODE_OF_CONDUCT` to your Python package"
msgstr "Agrega una `LICENSE` y un `CODE_OF_CONDUCT` a tu paquete de Python"

it's unclear weather in Spanish the person will create files called the same or if they'll use the English names.

flpm commented 1 month ago

Hi @ncclementi, gracias for the issue!

Good catch! We will add more details to the Translation Guide to cover cases like this.

I believe these are recommendations for people to add those files to their projects when creating them, so I would translate these as something like "Agrega un fichero LICENSE con la licencia ..."

RobPasMue commented 1 month ago

General guidelines on how to translate tech words and the person perspective (first person, second person... See #341) should be definitely discussed. Happy to help there!

kierisi commented 1 month ago

@all-contributors please add @ncclementi for code, review

allcontributors[bot] commented 1 month ago

@kierisi

I've put up a pull request to add @ncclementi! :tada:

flpm commented 3 weeks ago

Since we solved this particular question, we will continue the general discussion in issue #341