From 1c8e39eaef0cebef20d1e2760c2cfd75a9b83d89 Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Fri, 30 Aug 2024 22:40:01 +0200 Subject: [PATCH 1/2] Add a fragment about translating code examples --- documentation/translating.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/documentation/translating.rst b/documentation/translating.rst index 12aea204e..0baeae09d 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/ From 7a8b5b41b31ab8736f8c1c34e2acbe8c638ffc0e Mon Sep 17 00:00:00 2001 From: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Date: Sat, 31 Aug 2024 07:27:49 +0100 Subject: [PATCH 2/2] Update documentation/translating.rst --- documentation/translating.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/documentation/translating.rst b/documentation/translating.rst index 0baeae09d..1645eb7f2 100644 --- a/documentation/translating.rst +++ b/documentation/translating.rst @@ -234,8 +234,9 @@ 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. +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. .. _translation_wg: https://wiki.python.org/psf/TranslationWG/Charter .. _translation_ml: https://mail.python.org/mailman3/lists/translation.python.org/