Create alignment between documentation style guide and form help text guidelines
Doc style guide:
We recommend avoiding Latin abbreviations, such as “e.g.,” “i.e.,” or “etc.,” as even native users of English might misunderstand them.
- Instead of “i.e.”, use “that is.”
- Instead of “e.g.”, use “for example.”
- Instead of “etc.”, either use “and so on” or consider editing it out, since it can be vague.
Help text guidelines:
Contextual: An example or an explanation of the field, not a generic “Enter” or a repetition of the label. If it’s an example, it must start with “e.g.”.
We should align these two guidelines, in order to be consistent.