Inclusive writing

How to write for a global audience

Be clear.

Use plain language, simple sentence construction, and active voice.

If using acronyms, spell out the full term on its first usage with the abbreviation in parenthesis.

Use articles before nouns.

Avoid words that could be interpreted in multiple ways. Check with localization if you aren't sure.

Be mindful of length

English words can more than double in length in other locales, so pay attention to character limits and expect strings to grow. To get an idea of how long a string could grow search the cak locale in Transvision.

Handle humor carefully

Humor often doesn’t translate so handle this with care. If there is a need for more personality in copy, include a localization note explaining the rationale behind the original choice and possibly provide a simpler alternative.

Avoid colloquialisms and cultural references.

Avoid US American sports analogies like "home run" and celebration or seasonal events that only make sense in some parts of the world (e.g. "Mother’s day" and "return to school" happen at very different times).