Text-only companion

Plain Language Writing & Design

Mirrors the course slide deck. The slides title the course “Plain Language Writing and Design,” with Carriann Lane.

This page holds the same content as the slide presentation, as plain, structured text. It works with screen readers and keyboard navigation, reflows to any text size or zoom, and follows your device’s light or dark setting.

Getting around: use your screen reader’s heading commands, or the list below, to jump between sections. Every section is a heading, and the four text features are numbered in order. Under each section title, a short line names the slides it mirrors, so you can follow along in class. A few slides are held in reserve; where a slide may be skipped in class, this page says so.

What is plain language writing and design?

Slides 2–3.

Clear language and layouts that make information easier for everyone to find and understand.

Testing understanding

How can we tell if we’ve done that well?

We observe how people respond to key points after they read them.

Back to top

Try it: the benefits eligibility example

Slides 4–9.

Let’s respond to some information. If your benefits policy says:

You establish initial benefits eligibility the first day of the second month after receiving at least 240 total hours over three full, consecutive months.

And you begin on January 13 . . . on what date will your health insurance coverage begin?

In class, a poll asks: please tell us the date you would first feel comfortable scheduling an important health care visit that your health insurance policy covers.

Work out your answer first. Then open the reveal.

Reveal what the policy writer tried to tell us
  • February 13: starting point.
  • March, April, May: 240 hours on paychecks received in three full, consecutive months.
  • June: first month after.
  • July 1: second month after—coverage begins.

Was that plain language?

Did they convey that answer in a way that was easy to understand?

Identifying confusing language

What words or terms might confuse readers? Read the policy once more:

“You establish initial benefits eligibility the first day of the second month after receiving at least 240 total hours over three full, consecutive months.”
Reveal some to consider
  • initial benefits eligibility
  • receiving (hours)
  • full, consecutive months

Back to top

The goals of plain language

Slides 10–12.

Readers can:

We have many ways of reading

People read in many ways. Consider how information flows when read with screen readers, captioning, accessibility, and language access tools.

How to meet plain language goals

Write and design with readers in mind.

These are our performance objectives.

Back to top

Step 1: Know your readers

Slides 13–22.

Step 1: seek sources of insight to learn about and meet the needs of those who use what you write.

Get to know your users

Who uses what you write?

Six questions to answer for each type of reader

  1. What do they already know about the topic?
  2. What information, direction, report, or requests do they expect to receive? Let this inform where you place key points. This info should come to the top.
  3. What beliefs and preferences exist? Culture and tradition, mental, social and organizational norms have powerful influence. Let your understanding inform how you position info and insights for this audience.
  4. What do you want readers to do after reading?
  5. Why should they do what you say or ask?
  6. Whom have we left out? Do we know of people or businesses excluded or underserved by the way we convey information? Do we observe areas of silence or gaps?

Meet readers’ needs with good info design

Reflect on your readers’ needs as you choose, group, and place information.

What will they find useful and logical?

Back to top

Step 2: Use good information design

Slides 23–28.

Step 2: use that knowledge to practice good information design.

Good information design defined

Good information design:

Dive or discard?

How long does it take you to decide: dive in or discard? In class, tell us what comes closest:

Reveal how quickly we decide

We take very little time to decide if we will read something or not.

  • Email: 18 seconds.
  • Web page: 20 seconds.
  • One printed page: 60 seconds.

BLUF: bottom line up front

Back to top

Exercise 1: Applying design thinking to write better messages

Slides 29–42. Some review slides in this stretch may be skipped in class.

Let’s revise an email message to help readers find and understand key points quickly. We’ll revise the email message to make it work well for readers who must act upon it. Make any changes you see fit.

In this message, we want to

And we want this message to BLUF—get the bottom line up front:

Work time, then review

You work on the exercise on your own. When work time ends, you may submit your revision for feedback if you wish. Would you like to share your revision?

Let’s talk about it

The review walks through these questions. Answer each for your own revision.

The review can close with a before-and-after look at our revision, if the class would like to see it. (Sometimes skipped in class.)

Back to top

Four text features that make language plain

Slides 43–44.

What can we do to make language plain? Commit to four text features that make everything easier to read and understand:

  1. Clear, simple, common words.
  2. Statements written in the active voice.
  3. Pronouns that name the reader (you) and the agency (we/us).
  4. Shorter sentences and paragraphs.

Back to top

Measure your reading ease

Slides 45–66. Slides 53–61 are troubleshooting steps your facilitator shows only when needed.

Let’s define “easier to read”

Our reading ease standard

Let’s define our goal:

WCAG—the Web Content Accessibility Guidelines—is the standard for making digital content usable by everyone.

Finding our reading ease scores

Do you know how to find your stats? Microsoft Word builds them into the Editor panel. Can you open MS Word right now?

We must use the Editor tool. To open it:

Checking in . . . when you’ve opened the Editor pane, let me know.

How to get to and activate document stats

The readability statistics will open in a new window, right on your screen. The statistics include two measures of readability. You can pay attention to either grade level or reading ease—just use what works best for you.

If your Editor panel did not show reading ease stats

Slides 53–61. Your facilitator shows these only if the stats don’t appear; they may be skipped in class.

You may need to go to your proofing settings and turn this feature on.

Then go back: open the Editor panel again, navigate to Document Stats, and hear or view your stats. The steps repeat the ones above—F7 or Alt+Q to open the Editor, Tab to the Insights section, select Document Stats, and press Enter to confirm. (You can also navigate to the Review tab, then select Editor to open the panel.)

Stats for one part of a document only

If you want to know the stats for one part of your document only, select the text first:

Next, run the check and review stats: (sometimes skipped in class)

Checking in . . . what is the reading ease of your document?

Leading indicators: sentence length and percent passive

What about those other stats? Key metrics can help us boost reading ease:

The true measure of plain language success

What’s the true test of success? Readers can understand and recall key points after one reading.

That brings us back to . . . four text features that make everything easier to read and understand.

Back to top

Feature 1: Clear, common words

Slides 67–88.

Write more like you speak for clearer meaning

Let’s choose a simpler, clearer word for each common workplace word below. Try your own swap for each, then open the reveal.

Reveal the simpler words
Common workplace words and their simpler, clearer swaps
Instead ofWrite
accompanied bywith
affix signaturesign
finalizefinish
promulgatesend or publish

Simplifying Latin by using plain English

One more: pursuant to.

Reveal the plain English

In, under, [x] requires, [x] states.

Not “per,” which is Latin and means “a” or “an.”

Activity: simplifying common business words

Let’s continue simplifying common business words. In the chat, your facilitator places a link to the next exercise. It offers you the chance to do a little individual practice with feedback.

More simple alternatives: the word list

Simple swaps—try each before you open the reveal:

Reveal the simple swaps
More business words and their simple swaps
Instead ofWrite
demonstrateshow
implement (verb)apply or use
verificationproof
antithesisopposite
pertaining toabout
consequenceresult
cognizantaware or know
subsequentnext, following, after

Great work! By simplifying complex words you don’t have to use, you’ve made great gains in reading ease. That should always be your first move.

What’s next?

We must clarify the complex words we must use, and those that we cannot simplify further without losing context or accuracy.

What makes a word complex? We call words with multiple syllables and specialized meaning complex. We simplified long words. Now we need to tackle specialized meaning.

Here’s a great example of plain language even when complex words must be used: (sometimes skipped in class)

Vocational rehabilitation is a service that helps people aged 14 and up with disabilities start or continue working.

Agency-specific complex words

Some examples:

We can easily simplify some. Try eligibility, authorization, and comprehensive, then open the reveal.

Reveal the simpler choices
Agency-specific complex words and their simpler choices
Instead ofWrite
eligibilitycan get, can receive, can participate, have a right to
authorizationapproval
comprehensivefull

Handling the complex words we must keep

For others, we might need to find a way to:

In what ways do you do that now?

Some plain language swaps: (sometimes skipped in class)

Making meaning clear: plain language swaps for phrases we must keep accurate
Instead ofWrite
authorization processgetting approval for services
comprehensive documentationall your paperwork
determine eligibilitydecide if you qualify
rehabilitation servicesservices
receive notificationwe will let you know
initial appointmentfirst appointment

Activity: making meaning clear

Work time for activity 2, “Making Meaning Clear.” You revise two originals. Try each one before you open its reveals.

Original 1

Original 1 It’s important we have comprehensive documentation completed so that we understand the eligibility determinations that have been finalized. Understanding which eligibility determinations have been finalized is an important part of compliance monitoring, quality assurance, and federal reporting.
Reveal the plain language swaps for original 1
Plain language swaps for original 1
Instead ofWrite
comprehensive documentation completedcomplete all paperwork
understand the eligibility determinations that have been finalizedknow who qualifies for services
compliance monitoring, quality assurance, and federal reportingfollow the rules and report correctly to the federal government
Reveal our revision of original 1
Revised We need to complete all paperwork, so we know who qualifies for services. This information helps us follow the rules and report correctly to the federal government.

Original 2

Original 2 The compliance dashlet will display comprehensive metrics and functionality for reporting structure analysis, users with statewide case access can utilize the modifications to review calculations for service authorization totals.
Reveal the plain language swaps for original 2
Plain language swaps for original 2
Instead ofWrite
compliance dashlettracking tool (or compliance tool)
displayshow
comprehensive metricscomplete measurements (or all the numbers)
functionalityfeatures (or tools)
reporting structure analysisreport breakdown
utilizeuse
modificationschanges
review calculationscheck the math (or see totals)
service authorization totalsapproved service amounts (or total approved services)
Reveal our revision of original 2
Revised The compliance tool now shows better data for analyzing reports. If you have access to all state cases, you can use the new features to see totals for approved services.

Back to top

Feature 2: Statements in the active voice

Slides 89–99.

Step 1: Follow a simple form

When you write your own sentences, follow a simple form: doers—doing—something (subject—verb—object).

Step 2: Answer two questions

If you need clarity, answer these two questions, in order:

  1. What happens in this sentence?
  2. For every action you find—who or what makes it happen?

Step 3: Keep the doer next to the action

Use the answers to rewrite the phrase, placing the doer (subject) right next to the action (verb). Try not to place any other words between them. The slide illustrates this with a drawing of two people holding hands, one labeled “noun” and one labeled “verb”—a reminder that the noun comes first, followed by the verb, and we don’t want to separate them.

Step 4: Notice nouns hiding verbs

Noun phrases and the verbs hiding inside them
Instead ofWrite
makes a determinationdetermines or decides
ensures validationvalidates or confirms
conduct a meetingmeet

Steps 5 and 6: Let’s activate a sentence together

Original Leave without pay will be granted for the following reasons.
  1. What happens in this sentence? Someone grants leave.
  2. Who or what grants leave? We?
Reveal the activated sentence
Activated, becomes We will grant leave without pay for the following reasons.

Activity: writing in the active voice

Let’s practice writing in the active voice. In the chat, your facilitator places a link to the next exercise. It offers you the chance to do a little individual practice with feedback. Work time follows, then Q and A: what questions do you have?

Back to top

Feature 3: Familiar pronouns—you and we

Slides 100–101.

Use the pronoun “you” for the reader, and use “we” for the agency. The slide shows two cartoon figures talking; their conversation bubbles say “We for agencies” and “You for readers.”

We will notify you when we approve your services.
You may request leave without pay.

Back to top

Feature 4: Short sentences and paragraphs

Slides 102–104.

Keep sentences under 18 words

Under 18 words on average = 97% of people who can read for information at the 8th grade level can read sentences like this one time and recall the key points.

One sentence = one idea.

Keep paragraphs short

Consider how readers will likely access the document. On mobile? On a large screen? Adapt for the medium.

Back to top

Great work today

Slide 105.

You’re equipped to write everything in plain language.

Please check your email to find a link to your course evaluation.

Back to top