Explain that using native language identifiers

improves code clarity and maintainability.
This commit is contained in:
Martin v. Löwis 2007-05-17 12:10:44 +00:00
parent fd83b47657
commit ae26a8cde2
1 changed files with 8 additions and 5 deletions

View File

@ -20,11 +20,14 @@ Cyrillic, Greek, Kanji, etc.) in Python identifiers.
Rationale
=========
Python code is written by many people in the world who are not familiar with the
English language, or even well-acquainted with the Latin writing system. Such
developers often desire to define classes and functions with names in their
native languages, rather than having to come up with an (often incorrect)
English translation of the concept they want to name.
Python code is written by many people in the world who are not
familiar with the English language, or even well-acquainted with the
Latin writing system. Such developers often desire to define classes
and functions with names in their native languages, rather than having
to come up with an (often incorrect) English translation of the
concept they want to name. By using identifiers in their native
language, code clarity and maintainability of the code among
speakers of that language improves.
For some languages, common transliteration systems exist (in particular, for the
Latin-based writing systems). For other languages, users have larger