# HG changeset patch
# User Noe Gaumont <ngaumont@logilab.fr>
# Date 1555593035 -7200
# Node ID 0951dcdcfd5add40b671d31eab0ca2e708d0da32
# Parent  f97eba3156c0533be65890edb414c5ba360dde06
[doc] Clarify sentences

diff -r f97eba3156c0 -r 0951dcdcfd5a doc/book/devweb/internationalization.rst
--- a/doc/book/devweb/internationalization.rst	Thu Apr 18 15:05:13 2019 +0200
+++ b/doc/book/devweb/internationalization.rst	Thu Apr 18 15:10:35 2019 +0200
@@ -58,7 +58,7 @@
 retrieve the proper translation of translation strings in the
 requested language.
 
-Finally you can also use the `__` attribute of request object to get a
+Finally you can also use the `__` (two underscores) attribute of request object to get a
 translation for a string *which should not itself added to the catalog*,
 usually in case where the actual msgid is created by string interpolation ::
 
@@ -70,11 +70,11 @@
 Translations in cubicweb-tal template can also be done with TAL tags
 `i18n:content` and `i18n:replace`.
 
-If you need to add messages on top of those that can be found in the source,
+If you need to mark other messages as translatable,
 you can create a file named `i18n/static-messages.pot`.
 
 You could put there messages not found in the python sources or
-overrides for some messages of used cubes.
+overrides some messages that are in cubes used in the dependencies.
 
 Generated string
 ````````````````