Improve i18n translator documentation

@nedbat can you please review?

@lamagnifica can you review for clarity of language?

Thanks!