• Avoid specialized meanings of familiar vocabulary, unless explanations are provided.
  • Avoid the passive voice.
  • Avoid complex sentence structures.
  • Make link phrases terse yet meaningful enough so they make sense when read out of context, alone or as part of a series of links.

A revised version of guidelines included the following advice:

5.1 Writing style

The following writing style suggestions should help make the content of your site easier to read for everyone, especially people with reading and/or cognitive disabilities. Several guides (including [HACKER]) discuss these and other writing style issues in more detail.

  • Strive for clear and accurate headings and link descriptions. This includes using link phrases that are terse and that make sense when read out of context or as part of a series of links (Some users browse by jumping from link to link and listening only to link text.) Use informative headings so that users can scan a page quickly for information rather than reading it in detail.
  • State the topic of the sentence or paragraph at the beginning of the sentence or paragraph (this is called "front-loading"). This will help both people who are skimming visually, but also people who use speech synthesizers. "Skimming" with speech currently means that the user jumps from heading to heading, or paragraph to paragraph and listens to just enough words to determine whether the current chunk of information (heading, paragraph, link, etc.) interests them. If the main idea of the paragraph is in the middle or at the end, speech users may have to listen to most of the document before finding what they want. Depending on what the user is looking for and how much they know about the topic, search features may also help users locate content more quickly.
  • Limit each paragraph to one main idea.
  • Avoid slang, jargon, and specialized meanings of familiar words, unless defined within your document.
  • Favor words that are commonly used. For example, use "begin" rather than "commence" or use "try" rather than "endeavor."
  • Use active rather than passive verbs.
  • Avoid complex sentence structures.

To help determine whether your document is easy to read, consider using the Gunning-Fog reading measure (described in [SPOOL] with examples and the algorithm online at [TECHHEAD]). This algorithm generally produces a lower score when content is easier to read. As example results, the Bible, Shakespeare, Mark Twain, and TV Guide all have Fog indexes of about 6. Time, Newsweek, and the Wall St. Journal an average Fog index of about 11.

black line image
Previous page Table of Contents Next page