translating.rst

Translating

Python documentation translations are governed by PEP 545. They are built by docsbuild-scripts and hosted on docs.python.org. There are several documentation translations already in production; others are works in progress. See the dashboard for details.

Language	Contact	Links
Arabic (ar)	Abdur-Rahmaan Janhangeer (:github-user:`Abdur-rahmaanJ`)	:github:`GitHub <Abdur-rahmaanJ/python-docs-ar>`
Bengali (bn_IN)	Kushal Das (:github-user:`kushaldas`)	:github:`GitHub <python/python-docs-bn-in>`
French (fr)	Julien Palard (:github-user:`JulienPalard`)	:github:`GitHub <python/python-docs-fr>`
Greek (gr)	Lysandros Nikolaou (:github-user:`lysnikolaou`), Fanis Petkos (:github-user:`thepetk`), Panagiotis Skias (:github-user:`skpanagiotis`)	:github:`GitHub <pygreece/python-docs-gr>`
Hindi (hi_IN)	Sanyam Khurana (:github-user:`CuriousLearner`)	:github:`GitHub <CuriousLearner/python-docs-hi-in>`
Hungarian (hu)	Tamás Bajusz (:github-user:`gbtami`)	:github:`GitHub <python/python-docs-hu>`, mailing list
Indonesian (id)	Irvan Putra (:github-user:`irvan-putra`), Jeff Jacobson (:github-user:`jwjacobson`)	:github:`GitHub <python/python-docs-id>`
Italian (it)	Alessandro Cucci (email)	:github:`GitHub <python/python-docs-it>`, original mail
Japanese (ja)	Kinebuchi Tomohiko (:github-user:`cocoatomo`), Atsuo Ishimoto (:github-user:`atsuoishimoto`)	:github:`GitHub <python/python-docs-ja>`
Korean (ko)	오동권 (:github-user:`flowdas`)	:github:`GitHub <python/python-docs-ko>`
Marathi (mr)	Sanket Garade (:github-user:`sanketgarade`, email)	:github:`GitHub <sanketgarade/python-doc-mr>`
Lithuanian (lt)	Albertas Gimbutas (:github-user:`albertas`, email)	Original mail
Persian (fa)	Alireza Shabani (:github-user:`revisto`)	:github:`GitHub <revisto/python-docs-fa>`
Polish (pl)	Maciej Olko (:github-user:`m-aciek`)	:github:`GitHub <python/python-docs-pl>`, Transifex, original mail
Portuguese (pt)	Gustavo Toffo
Brazilian Portuguese (pt-br)	Rafael Fontenelle (:github-user:`rffontenelle`), Marco Rougeth (:github-user:`rougeth`)	:github:`GitHub <python/python-docs-pt-br>`, wiki, Telegram, article
Romanian (ro)	Octavian Mustafa (:github-user:`octaG-M`, email)	:github:`GitHub <octaG-M/python-docs-ro>`
Russian (ru)	Daniil Kolesnikov (:github-user:`MLGRussianXP`, email)	:github:`GitHub <MLGRussianXP/python-docs-ru>`, mail
Simplified Chinese (zh-cn)	Shengjing Zhu (:github-user:`zhsj`), Du, Meng (:github-user:`dumeng`)	:github:`GitHub <python/python-docs-zh-cn>`, Transifex
Spanish (es)	Raúl Cumplido	:github:`GitHub <python/python-docs-es>`
Traditional Chinese (zh-tw)	王威翔 Matt Wang (:github-user:`mattwang44`), Josix Wang	:github:`GitHub <python/python-docs-zh-tw>`
Turkish (tr)	Ege Akman (:github-user:`egeakman`)	:github:`GitHub <python/python-docs-tr>`, RTD
Ukrainian (uk)	Dmytro Kazanzhy (:github-user:`kazanzhy`, email)	:github:`GitHub <python/python-docs-uk>`, Transifex

How to get help

Discussions about translations occur on the Python Docs Discord #translations channel, translation mailing list, and there's a Libera.Chat IRC channel, #python-doc.

Translation FAQ

Which version of the Python documentation should be translated?

Consensus is to work on the current stable version. You can then propagate your translation from one branch to another using :pypi:`pomerge`.

How should I translate code examples?

Translate values in code examples (i.e. string literals) and comments. Don't translate keywords or names, including variable, function, class, argument, and attribute names.