fbpx

Write Your Web Content Clearly and Simply for Accessibility P

Is it Possible to Write “Clearly and Simply”?

 

The task of writing clearly and simply has never been either clear or simple.  In fact, it can be one of the most difficult of all writing tasks.  Clear and simple writing is an art to which many aspire and few achieve.

“My aim is to put down on paper what I see and what I feel in the best and simplest way.”                                                                        —Ernest Hemingway

Even so, the understandability of your web content depends upon clear and simple writing.  Unclear or confusing writing is an accessibility barrier to all readers, but can be especially difficult for people with reading disorders or cognitive disabilities.

“Unless one is a genius, it is best to aim at being intelligible.”
—Anthony Hope Hawkins

 

Language and Cultural Differences Matter

 

To complicate matters, the “rules” of clear and simple writing in English may not apply at all in other languages.  Rules may not apply between cultures that speak the same language.  

Many English-speaking countries value directness and explicitness in written communication.  Other cultures feel that this style is too blunt, and perhaps even insulting to readers.

 

Despite the difficulties in defining the meaning of “clear and simple” writing, the suggestions in this section may still benefit writers of web content.  The suggestions serve as general guidelines for writing clear and simple English, primarily from an American English perspective.  

Those who write in other languages should seek resources that apply specifically to those languages.

 

Cognitive Abilities Matter

 

Not everyone reads at the same level or has the ability to understand text content, even when presented clearly and simply.  Reading disorders, memory disorders, attention deficit disorders, and other conditions which affect the brain’s cognitive processes can compromise a person’s ability to benefit from text.  

The guidelines presented below will improve readability for many people, but not for all.

 

General Writing Guidelines

 

The guidelines presented here are not a complete list, nor do they apply to every situation, but they are a good starting point.  Writers who take these guidelines seriously are more likely to write clearly and simply.

“Writing comes more easily if you have something to say.”
—Sholem Asch

 

Organize a Logical Outline of Your Ideas

 

This may be the most important guideline of all.  You have to think clearly about a topic in order to communicate it clearly.  Your organizating process should be ongoing, starting before any words are written and continuing throughout the entire process.

“If any man wishes to write in a clear style, let him first be clear in his thoughts.”
—Johann Wolfgang von Goethe

There is nothing wrong with reorganizing a paper as you write it.  When you think you’re finished, take the opportunity to analyze it one more time to see if the organization still makes sense to you.  If it does, great!  If not, try again!

   

 

Tell Your Readers What You’ll Teach Them

 

Teaching others is best accomplished by creating stories that engage your audience and move them to act.  The formula to follow is to begin with an introduction, or overview of the paper’s ideas.  Explain the ideas in the main body of your text.  Then summarize or review the ideas at the end.

 

Example:  In a simplified format, here is a structural analysis of ideas for a paper about baldness:

 

Introduction:  Tell them what you’re going to teach them

Not everyone appreciates baldness as they should.  There are advantages to being bald.

 

Body:  Teach them

Main idea 1:  Bald people don’t have to worry about the cost of haircuts.  They can cut their own hair with a razor or clippers.

Main idea 2:  Bald people don’t have to style their hair.  They only have to dry their head with a towel after showering, and are then free to move on to other more relevant activities, like reading the comics, practicing yoga, or climbing trees.

Main idea 3:  Even on windy days, bald people never get hair in their eyes or mouth, at least not their own hair, which makes windy days more bearable for the vast majority of people who don’t particularly like the taste of hair.

 

Review and Conclusion:  Teach them what you told them

Baldness allows for some under-appreciated conveniences in life, in terms of haircuts, styling, and windy days.  You ought to consider being bald.

 

 

Capture Your Readers Interest

 

Capture the attention of your readers by including relevant details that motivate them to continue reading.

Here are some thoughts by famous individuals about the importance of making things interesting:

 

“If you would not be forgotten as soon as you are dead, either write things worth reading or do things worth writing.”   —Benjamin Franklin

 

“Imagination is more important than knowledge.”   —Albert Einstein

 

“What we want is a story that starts with an earthquake and builds to a climax.”   —Samuel Goldwyn

 

Stick to and Make Your Point

 

If you stray from your main point, the less likely people will be to remember what you are trying to teach them.

 

Write for Your Target Audience

 

Your writing should engage your audience.  You should write differently for a classroom of first-graders than you would for a committee of post-graduate scholars.  In addition, you should take into account people’s areas of expertise, even if they have the same level of education or intelligence.  

Cultural and gender differences can also play a role in defining a target audience.  As you write, keep your audience’s characteristics in mind and write accordingly.

 

Write Cohesive Paragraphs With a Single Idea

 

Your writing needs to be engaging and conversational.  All of the ideas in a paragraph should relate back to the main point.  If possible, put the main idea of the paragraph in the first sentence.

 

An example of a cohesive paragraph:

The following paragraph presents an idea about teams.  The first sentence clearly states the main idea of the paragraph.  As you read this paragraph, the other sentences in the paragraph support the main idea in the first sentence.

 

Obstacles are a continual fact of life for teams. 

They occur from the moment a potential team gathers until the team comes to an end.  Obstacles also differ as much as the teams, performance challenges, organizational settings, and business contexts that produce them.  

The Burlington Northern Intermodal Team, for example, encountered weak support from management, policies against advertising, distrust of truckers, and mediocre talent in the intermodal department.  It also faced bad weather, intense competition, and a poor economy when it had to prove its strategy with the two new hubs.  

Any of these obstacles could have derailed the team’s progress and performance. None of them did. Indeed, working through the obstacles made the team stronger.

(From “The Wisdom of Teams” by Jon R. Katzenbach and Douglas K. Smith, HarperBusiness press 1994, page 149.)

 

Assume Your Readers are Smart

 

However, do not assume that they know the subject matter as well as you do.

The amount of explaining you need to do depends upon how familiar your audience is with the topic.  Explaining concepts is not insulting; it is helpful.  Your explanations show that you respect the reader.

Some people with cognitive disabilities may need more explanation than others, but when you write for general audiences, assume a general level of intelligence.

 

Some experts say writers should aim for “eighth grade level” writing.  It is difficult to determine for sure what this means.  Many popular magazines, such as Readers Digest and Ladies’ Home Journal are written at about this level.  News sources such as Newsweek are written at a slightly higher level, approximately 10th grade.

 

Use Familiar Words and Phrases

 

Writers should strive to communicate with their readers, not try to impress your readers by using uncommon or showy words.  You’ve failed if your audience does not understand what you have written.

Unfamiliar words to many people:  “The populous legion of impecunious vagrants congregated near the basilica.”

More familiar words:  “The large crowd of poor homeless people gathered near the old church.”

 

Write Using Your Active Voice

 

Passive voice weakens the action of a sentence by distancing the action from the subjects performing the action. Active voice links the subjects directly with the action.

 

Passive Voice:

  • The food was eaten at the party by the guests.
  • A good time was had by all.
  • The result of building a highway through the farmland was increased profit-seeking by some property owners and the eventual loss of land adjacent to the highway to contractors’ commercial and residential construction projects.

 

 Active Voice:

  • The guests ate the food at the party.
  • We all had a good time. OR We all enjoyed ourselves.
  • Building a highway through the farmland caused some property owners to seek profits by selling their land to contractors who eventually constructed commercial and residential projects on the land adjacent to the highway.

 

Avoid Using Slang and Jargon

 

Slang and jargon can be useful to people who understand it, but confusing to people who don’t.  The examples below illustrate the importance of this step.

Computer jargon:

“Some software companies issue crippleware demos.  Others issue shareware or nagware.  Still others issue nothing but vaporware.”

The words “crippleware,” “demos,” “shareware,” “nagware,” and “vaporware,” are familiar to many people in the computer industry, but mean little or nothing to people unfamiliar with the terms.

Social theory jargon:

“Critical theory seeks to problematize the hegemonic reification of oppressive stratified social constructs.”

The above sentence accurately describes one aspect of the social movement known as critical theory.  However, it uses terms that are somewhat less common outside of critical theory, and which have specific meanings within the theoretical perspective.  The example sentence may confuse people who are unfamiliar with critical theory.

 

Use Parallel Sentence Construction

 

Make sure that the sentence construction is consistent within itself.

Non-parallel construction:  “His new sorting machine saves time, increases profitability, and worker satisfaction.”

Parallel Construction:  “His new sorting machine saves time, increases profitability, and increases worker satisfaction.”

One way to find out if the sentence contains parallel construction is to list each of the items one at a time in a complete sentence:

  1. His new sorting machine saves time.
  2. His new sorting machine increases profitability.
  3. His new sorting machine worker satisfaction.

The third sentence in this example obviously needs a verb to make the sentence complete and parallel with the previous sentences.

 

Write Using Positive Terms

 

Emphasize the way things are, were, will be, or would be.  Avoid the use of don’t, didn’t, and other words that structure a sentence from the perspective of the way things are not, were not, will not be, or would not be.

Negative terms:

  • Do not get dirty.
  • Don’t forget to water the flowers.
  • I didn’t remember where I was last night.
  • Choir members are not supposed to sing in ways that don’t blend with the rest of the choir.

 Positive terms:

  • Stay clean.
  • Remember to water the flowers.
  • I forgot where I was last night.
  • Choir members are supposed to sing in ways that blend with the rest of the choir.

 

Avoid Using Weak Verbs

 

Writers often use the verb “to be” when more active verbs may be more appropriate.  Over-use of the verb “to be” often forces writers to use the passive voice more than necessary.  The verb “to be” suggests passivity because it connects two entities that are essentially equal.

The phrase “A is B” essentially means “A equals B.”  The relationship between A and B is static.  In contrast, other verbs such as “to improve,” “to clarify,” “to modify,” or “to destroy” imply more of a dynamic relationship between A and B.

 

Weak verb (“is”):  One way to improve your writing is to use strong verbs.  (A = B).  One way to improve your writing = to use strong verbs.  The equal relationship between the two parts of the sentence implies no action.

 

Strong verb (“improve”):  Using stronger verbs can improve your writing.  (A improves B).  The subject of the sentence “using stronger verbs” performs the action of improving the object of the sentence “your writing”.

 

Avoid Using Multiple Negatives

 

Most readers find double negatives, or multiple negatives, a bit awkward, which can lead to confusion, or at least to slower comprehension.

Double negative:

  • Don’t forget to not open your mouth when you fall in a muddy puddle.
  • I don’t let them not help with the chores.

 

Single negative, or only positive phrase:

  • Don’t open your mouth when you fall in a muddy puddle.
    OR
    Keep your mouth closed when you fall in a muddy puddle.
  • I don’t let them avoid the chores.
    OR
    I make sure they help with the chores.

 

Write Giving Direct Instructions

 

Direct instructions can increase comprehension and place more of a sense of responsibility on the reader.

Indirect instructions:

  • Students should read chapter five.
  • It is best to eat a healthy breakfast before leaving the house in the morning.
  • It can be dangerous to attempt to walk on a tightrope stretched over a pit of hungry crocodiles, so this practice is highly discouraged.

 

Direct instructions:

  • Read chapter five.
  • Eat a healthy breakfast before leaving the house in the morning.
  • Don’t walk on a tightrope over a pit of hungry crocodiles.

 

Check Your Spelling

 

Use an automated spell checker, but also proof-read the document for correctly spelled words that are used incorrectly.

Incorrect spelling:  “I wanted to see hte sunset for myself.”

Incorrect words spelled correctly:  “Our products an services are the best ones fore the price.”

 

Write Avoiding Acronyms and Abbreviations

 

if possible; explain all acronyms and abbreviations.  Unfamiliar acronyms and abbreviations mean nothing to readers. Expanding acronyms and abbreviations allows readers to learn their meaning. This is especially true the first time, or the first few times, an acronym or abbreviation is used.

Unexplained acronyms and abbreviations:  “The teacher had to prepare an IEP for the children with LD and had to comply with the NCLB regs in order to meet AYP reqs.”

Explanations for acronyms, with abbreviations eliminated:  “The teacher had to prepare an Individualized Education Plan (IEP) for the children with learning disabilities (LD), and had to comply with the regulations of the No Child Left Behind (NCLB) Act in order to meet the Annual Yearly Progress (AYP) requirements.”

 

Write Short Sentences

 

Readers tend to lose the main point of long, run-on sentences. Help readers stay focused by creating shorter sentences.

 

“Good things, when short, are twice as good.”
—Gracián

Long, run-on sentence:  “We all agreed that we ought to eat at the new Greek restaurant in town, then see a movie, and, before going home, we should stop at the grocery store to buy milk for breakfast, because we ran out of milk earlier in the day and cold cereal doesn’t taste good without milk, especially not with orange juice, which gives cereal a tart, citrus flavor which is fine for drinking from a glass, but not so fine for eating with flakes of cereal.”

Multiple shorter sentences:  


Sentence 1:
 We all agreed that we ought to eat at the new Greek restaurant in town, then see a movie.

Sentence 2: Before going home, we should stop at the grocery store to buy milk for breakfast because we ran out of milk earlier in the day.
Sentence 3: Cold cereal doesn’t taste good without milk, especially not with orange juice.
Sentence 4: Orange juice gives cereal a tart, citrus flavor which is fine for drinking from a glass, but not so fine for eating with flakes of cereal.

 

Write Using Words Sparingly

 

“Omit needless words.  Vigorous writing is concise.  A sentence should contain no unnecessary words, a paragraph no unnecessary sentences, for the same reason that a drawing should have no unnecessary lines and a machine no unnecessary parts.”

—William Strunk, Jr.

 

Too wordy:  “It is my opinion that the explanation that was given by the teacher was delivered in a way that was not brief enough to be interesting, and was not understood by the class.”

Better:  “I think that the class misunderstood the teacher’s long, uninteresting explanation.”  OR “The class misunderstood the teacher’s long, uninteresting explanation.”

 

Writing for Users with Reading Disorders

 

All of the writing guidelines discussed above will improve the chances that users with reading disorders or cognitive disabilities will understand the text.  These guidelines will be insufficient for some users, especially for those who read poorly, or who cannot read at all.  Text content will always pose problems for these users.  Some of the recommendations most relevant to people with cognitive disabilities are the following:

 

Supplement your text with illustrations:  “The most drastic and perhaps the most useful solution for these audiences is to provide illustrations as alternatives to the text, or at least as enhancements of the textual content.  Do everything possible to clarify and simplify the text, then go one step further by supplementing the text with illustrations.”

Minimize your text:  “Pages with a large amount of text can intimidate users with reading difficulties.  For this audience, the less you say, the better.”

Be as concise as possible:  “Some people with cognitive disabilities have a hard time distinguishing between the literal meaning of ideas and implied meaning.  Sarcasm and parody can be especially confusing for some people.”

 

Stop Writing When You’re Finished

Say only what you need to say.

 

Can Writers Test for Readability?

 

Strictly speaking, writers cannot know for sure whether their writing is truly “clear and simple.”  No matter how well writers think they have explained a concept, some of your readers will almost always misunderstand.

 

Readability Tests

 

Algorithms, such as the Gunning Fog Index, Flesch Reading Ease Index, and Flesch-Kincaid Index attempt to evaluate the readability or reading level of text content. Such algorithms appeal to some experts because they are based on clear-cut mathematical formulas.  The tests produce measurable results.

Unfortunately, the tests’ emphasis on quantitative accuracy can mislead writers into thinking that achieving clear and simple writing is a well-defined, formulaic process, when it is not.  The algorithms themselves are somewhat questionable too, since they use such superficial criteria as the number of syllables, the number of words, the length of sentences, etc, all of which are indirect measures of readability, at best.

Users of Microsoft Word can evaluate written content against the Flesch Reading Ease scale and the Flesch-Kincaid Grade Level scale within the word processor itself.  Word also provides a percentage count of passive sentences with the lower the percentage the better.

 

To activate this feature in Word, go to the Tools menu, click Options, then click on the Spelling & Grammar tab.  Select the Check grammar with spelling check box and the Show readability statistics check box, and then click OK.  To use the feature, go to Tools > Spelling & Grammar and let Word run through the document for spelling and grammar errors.  At the end of this process, a dialogue box will pop up showing the readability score.

 

Other sources of software-based readability evaluators include:

Also, an online readability test using the Fog index is available from Juicy Studios.

Accessibility Toolbar