Accessible content

Most of the principles that apply to good technical documentation also apply to accessible technical documentation:

  • Use correct grammar and punctuation.

  • Use active voice and present tense.

  • Write clear, simple sentences.

  • Be consistent.

  • Avoid jargon, slang, and the like.

  • Beware of dangling modifiers.

  • Use the relative pronoun "that" where you might otherwise omit it.

  • Use the simplest terminology.

  • Use colours judiciously. Keep in mind that some colour-blind people cannot tell red from green.

    Make sure that your text colour contrasts sufficiently with your background colour.

Last updated