i18n documentation clarification wrt apostrophes

If these examples should be pulled out into their own source files, I can do that; I followed the existing style defined in these files, where short examples were inlined.