diff --git a/documentation/translations/python-logo-languages.svg b/documentation/translations/python-logo-languages.svg new file mode 100644 index 000000000..028690445 --- /dev/null +++ b/documentation/translations/python-logo-languages.svg @@ -0,0 +1,233 @@ + + + + diff --git a/documentation/translations/translating.rst b/documentation/translations/translating.rst index f1c3cfe71..f7d9dbb56 100644 --- a/documentation/translations/translating.rst +++ b/documentation/translations/translating.rst @@ -167,6 +167,39 @@ Roughly, translation works as follows: docs.python.org. +Motivation +========== + +The Python documentation is written in English, but Python is taught, learned, +and used around the world, in many languages. English is the native language +of only about 5% of the world's population, and fewer than a fifth more speak +it as an additional language [#f1]_. For many people, learning Python also +means overcoming a language barrier. They must learn not only Python, but also +enough English to be able to use the language's documentation. + +The United Nations Open Source Principles call on projects both to provide +documentation and to foster inclusive participation [#f2]_. Providing +documentation only in English limits who can benefit from it and who can +participate in the wider Python community. + +.. figure:: python-logo-languages.svg + :align: center + :alt: The word "Python" written in dozens of languages. + +.. Image drawn manually in Inkscape. The text in python-logo-languages.svg was + converted to paths before exporting for consistent rendering, contact + StanFromIreland for the original. + +Translations make Python's documentation accessible to a much wider audience. +They allow people to learn and use Python in a language they are confident in, +reducing the additional burden of learning through English. + +Translation also improves the English documentation. Translators review the +source text closely and often find bugs. As a result, translation therefore +benefits not only readers of other languages, but everyone who uses and +contributes to Python's documentation. + + How to get help =============== @@ -458,6 +491,12 @@ with the commit hash from before the files were moved): After running ``pomerge``, review the changes and commit the updated files. You may also need to rewrap the lines (see :pypi:`powrap`). +.. rubric:: Footnotes + +.. [#f1] Ethnologue, `What is the most spoken language? + `__ +.. [#f2] `United Nations Open Source Principles + `__ .. _discourse: https://discuss.python.org/c/documentation/translations/ .. _tx: https://explore.transifex.com/python-doc/python-newest/