diff --git a/documentation/translating.rst b/documentation/translating.rst
index 12aea204e5..0baeae09d8 100644
--- 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/