Add a fragment about translating code examples

python · Aug 30, 2024 · 1c8e39e · 1c8e39e
1 parent 3cea249
commit 1c8e39e
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/documentation/translating.rst b/documentation/translating.rst
@@ -230,5 +230,12 @@ As for every project, we have a *branch* per version.  We store ``.po``
 files in the root of the repository using the ``gettext_compact=0``
 style.
 
+
+How should I translate code examples?
+-------------------------------------
+
+Translate values (i.e. string literals) and comments.
+Don't translate keywords and names, e.g. of variables, functions, classes, arguments and attributes.
+
 .. _translation_wg: https://wiki.python.org/psf/TranslationWG/Charter
 .. _translation_ml: https://mail.python.org/mailman3/lists/translation.python.org/