From 6e5d53b6dad130113fe88daab6618b01944d93ab Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sat, 15 Aug 2026 20:05:47 +0100 Subject: [PATCH 1/4] Add a little section on the motivation behind translation --- documentation/translations/translating.rst | 37 ++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/documentation/translations/translating.rst b/documentation/translations/translating.rst index f1c3cfe71..d1866d784 100644 --- a/documentation/translations/translating.rst +++ b/documentation/translations/translating.rst @@ -167,6 +167,37 @@ Roughly, translation works as follows: docs.python.org. +Motivation +========== + +The Python documentation is written in English, however, Python is taught, +learned, and used around the world, in many languages. But, English is only 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. + +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 especially closely when translating and often find bugs. +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 +489,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/ From 229267ccbea982391a2d034b5af8e51bc85e31fa Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sat, 15 Aug 2026 20:08:25 +0100 Subject: [PATCH 2/4] Reword a tad --- documentation/translations/translating.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/translations/translating.rst b/documentation/translations/translating.rst index d1866d784..a0c3c05f7 100644 --- a/documentation/translations/translating.rst +++ b/documentation/translations/translating.rst @@ -170,12 +170,12 @@ Roughly, translation works as follows: Motivation ========== -The Python documentation is written in English, however, Python is taught, -learned, and used around the world, in many languages. But, English is only 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 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 @@ -192,10 +192,10 @@ 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 especially closely when translating and often find bugs. -Translation, therefore, benefits not only readers of other languages, but -everyone who uses and contributes to Python's documentation! +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 From 00f1dea7c93723da722f02e8e61121147040da27 Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sat, 15 Aug 2026 20:08:38 +0100 Subject: [PATCH 3/4] Whoops add figure --- .../translations/python-logo-languages.svg | 497 ++++++++++++++++++ 1 file changed, 497 insertions(+) create mode 100644 documentation/translations/python-logo-languages.svg diff --git a/documentation/translations/python-logo-languages.svg b/documentation/translations/python-logo-languages.svg new file mode 100644 index 000000000..fa6b8b03a --- /dev/null +++ b/documentation/translations/python-logo-languages.svg @@ -0,0 +1,497 @@ + + + +PythonpitonkrajtapitópüütonΠύθωνPíotón Pitãoпитонpytónpytonormպիթոնঅজগরპითონიअजगरパイソンពស់ថ្លាន់ 비단뱀പെരുമ്പാമ്പ്अजगर پیتونமலைப்பாம்புหลามازگرפִּיתוֹןپایتونluislang chatuinhlwathinsatoular sawapitonoፓይቶንకొండచిలువစပါးအုံး蟒蛇KrajtaPýtonपाइथनpeithonPytōnpytonپایتونАпитон From 10cded9aced282f3fd3dbe6a2d31e539c70021a3 Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Sat, 15 Aug 2026 20:52:40 +0100 Subject: [PATCH 4/4] Use better image --- .../translations/python-logo-languages.svg | 624 +++++------------- documentation/translations/translating.rst | 4 +- 2 files changed, 183 insertions(+), 445 deletions(-) diff --git a/documentation/translations/python-logo-languages.svg b/documentation/translations/python-logo-languages.svg index fa6b8b03a..028690445 100644 --- a/documentation/translations/python-logo-languages.svg +++ b/documentation/translations/python-logo-languages.svg @@ -27,8 +27,8 @@ inkscape:deskcolor="#d1d1d1" inkscape:document-units="mm" inkscape:zoom="1.5981902" - inkscape:cx="414.21852" - inkscape:cy="278.12709" + inkscape:cx="259.04301" + inkscape:cy="278.1271" inkscape:window-width="2048" inkscape:window-height="1083" inkscape:window-x="0" @@ -38,332 +38,140 @@ id="defs1" />PythonpitonkrajtapitópüütonΠύθωνPíotón Pitãoпитонpytónpytonormպիթոնঅজগরპითონიअजगरパイソンពស់ថ្លាន់ 비단뱀പെരുമ്പാമ്പ്अजगर پیتونமலைப்பாம்புหลามازگرפִּיתוֹןپایتونluislang chatuinhlwathinsatoular sawapitonoፓይቶንకొండచిలువစပါးအုံး蟒蛇KrajtaPýtonपाइथनpeithonPytōnpytonپایتونАпитон + style="font-size:6.08526px;font-family:'Source Code Pro';-inkscape-font-specification:'Source Code Pro, Normal';fill:#306998;fill-rule:evenodd;stroke:#306998;stroke-width:0.0264964;stroke-linecap:round" + transform="scale(0.8189117,1.2211329)" + aria-label="Апитон" /> diff --git a/documentation/translations/translating.rst b/documentation/translations/translating.rst index a0c3c05f7..f7d9dbb56 100644 --- a/documentation/translations/translating.rst +++ b/documentation/translations/translating.rst @@ -186,7 +186,9 @@ participate in the wider Python community. :align: center :alt: The word "Python" written in dozens of languages. -.. Image drawn manually in Inkscape. +.. 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,