- 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. |