Improve documentation about translations in API (bug 946738)