Improve documentation about translations in API (bug 946738)
Merge pull request #1500 from diox/improve-api-translations-docs

Improve documentation about translations in API  (bug 946738)