Fixed comments for translators example in the i18n documentation

The documentation regarding adding a comment for translators was confusing
as the example contained mismatching tags.
Merge pull request #1201 from takis/docs_typo

Fixed comments for translators example in the i18n documentation