--- a/doc/book/devweb/internationalization.rst	Thu Apr 18 04:40:23 2019 +0000
+++ b/doc/book/devweb/internationalization.rst	Thu Apr 18 15:05:13 2019 +0200
@@ -64,7 +64,7 @@
 
   self._cw.__('This %s' % etype)
 
-In this example ._cw.__` is used instead of ._cw._` so we don't have 'This %s' in
+In this example `._cw.__` is used instead of `._cw._` so we don't have 'This %s' in
 messages catalogs.
 
 Translations in cubicweb-tal template can also be done with TAL tags
@@ -149,7 +149,7 @@
 To update the translation catalogs you need to do:
 
 1. `cubicweb-ctl i18ncube <cube>`
-2. Edit the <cube>/i18n/xxx.po  files and add missing translations (empty `msgstr`)
+2. Edit the `<cube>/i18n/xxx.po` files and add missing translations (those with an empty `msgstr`)
 3. `hg ci -m "updated i18n catalogs"`
 4. `cubicweb-ctl i18ninstance <myinstance>`
 
@@ -280,8 +280,8 @@
 entity.dc_type(), eschema.display_name(req) or display_name(etype,
 req, form, context) methods/function calls will use them.
 
-It is also possible to explicitly use the with _cw.pgettext(context,
-msgid).
+It is also possible to explicitly use a context with `_cw.pgettext(context,
+msgid)`.
 
 
 Specialize translation for an application cube