well-written web content: even when it’s not your job, it’s your responsibility leslie...
TRANSCRIPT
![Page 1: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/1.jpg)
Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility
Leslie O’Flahavan, E-WRITE@LeslieOPLAINNovember 14, 2012
![Page 2: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/2.jpg)
Really, this workshop isn’t for ME. A friend of mine has a problem with web writing…
© E-WRITE 2012 2
![Page 3: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/3.jpg)
Overview
• How to write plain language web content
• How to convince colleagues that writing good web content is important
© E-WRITE 2012 3
![Page 4: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/4.jpg)
Today’s web writing topics
How to write:
1. Task-oriented, actionable web content
2. A bite, a snack, and a meal
3. Concise, non-fluffy web content
© E-WRITE 2012 4
![Page 5: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/5.jpg)
Today’s “how to get good content out of other people” topics
1. How to use before-and-after examples to illustrate web writing principles
2. When to refuse to publish web content that’s just not well written
3. How to use the wealth of new plain language resources
© E-WRITE 2012 5
![Page 6: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/6.jpg)
Know whether you are writing a lobby or a room
© E-WRITE 2012 6
![Page 7: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/7.jpg)
Write task-oriented, actionable web content
Helping people do things online (complete tasks) is web content’s highest calling
• Some web writing helps people know
• Some web writing helps people do
• Best practice: focus on top tasks
© E-WRITE 2012 7
![Page 8: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/8.jpg)
Four guidelines for writing task-oriented web content
1. Name the task clearly and provide an overview.
2. Make the task scannable as users may bookmark it and return frequently.
3. Provide an example, illustration, or screenshot when necessary.
4. Link to background info instead of including it in the task.
5. Make the web content substantive; don’t lock all the info about the task into the PDF form.
© E-WRITE 2012 8
![Page 9: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/9.jpg)
Name the task clearly and provide an overview
© E-WRITE 2012 9
![Page 10: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/10.jpg)
Make the task scannable
© E-WRITE 2012 10
![Page 11: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/11.jpg)
Provide an example, illustration, or screenshot
© E-WRITE 2012 11
![Page 12: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/12.jpg)
Link to background info instead of including it in the task
© E-WRITE 2012 12
![Page 13: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/13.jpg)
Practice writing task-oriented content
© E-WRITE 2012 13
![Page 14: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/14.jpg)
Write a bite, a snack, and a meal
© E-WRITE 2012 14
![Page 15: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/15.jpg)
Write a bite, a snack, and a meal
How content-hungry is the reader?
How much content does the web writer provide?
• Bite
• Snack
• Meal
© E-WRITE 2012 15
![Page 16: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/16.jpg)
Sample bites, snacks, and meals
© E-WRITE 2012 16
![Page 17: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/17.jpg)
Sample bites, snacks, and meals
© E-WRITE 2012 17
![Page 18: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/18.jpg)
Sample bites, snacks, and meals
© E-WRITE 2012 18
![Page 19: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/19.jpg)
These bites and snacks need work
© E-WRITE 2012 19
![Page 20: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/20.jpg)
Practice writing a bite and a snack
© E-WRITE 2012 20
![Page 21: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/21.jpg)
© E-WRITE 2012 21
Edit web content for two types of conciseness
1. Relevance: Review each chunk to determine whether is essential to the content’s overall purpose or message.
2. Brevity: Edit conscientiously so the content is as brief as possible:
– 1 word, not 2– 20-word sentences, not 45-word sentences– 3-sentence paragraphs, not 15-sentence
paragraphs
![Page 22: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/22.jpg)
Step 1 in editing for conciseness: Relevance
Review the Health Information and Quality Authority’s “What we do and why” page:
1. Is each chunk of content relevant to the overall purpose: to explain who they are and what they do?
2. Cross out any chunk of content that is not relevant.
3. No wordsmithing! No copyediting!
© E-WRITE 2012 22
![Page 23: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/23.jpg)
© E-WRITE 2012 23
Our conclusion? Is all the web content “Type 1” relevant?
![Page 24: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/24.jpg)
© E-WRITE 2012 24
Step 2 in editing for conciseness: Brevity
What’s the effect of cutting word count? • A 10% cut eliminates annoying phrases
—“in order to”—and unnecessary modifiers to lightly refresh the text.
• A 25% cut eliminates all types of word fluff and may alter the message slightly.
• A 50% cut alters the message: narrower scope, fewer persuasive points, fewer examples, etc.
![Page 25: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/25.jpg)
© E-WRITE 2012 25
Test the web writing maxim: “The best thing you can do for your content is cut by 50%”
![Page 26: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/26.jpg)
© E-WRITE 2012 26
My 76-word version
Approach We improve your organization’s performance by maximizing the
capabilities of your systems and personnel. Our consultants employ our proven six-step approach to gain you quantifiable results:
1. Assess the department to discover problems and opportunities.2. Analyze day-to-day operations to understand the department’s
performance.3. Recommend improvements.4. Partner with administration, physicians, and front-line staff to
solve problems.5. Provide support while you implement new processes.6. Maintain contact so you can sustain your successes.
![Page 27: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/27.jpg)
© E-WRITE 2012 27
“Another guy’s” much better 90-word version
ApproachWe improve our clients’ performance—people and systems alike. Our
techniques are proven, our consultants are respected, and our clients gain measurable benefits.
Here’s how we do it:
• Assess. What's not working? What's not making sense? Where are the opportunities?
• Observe. Dive into day-to-day operations to learn the ground truth.• Recommend. Identify specific improvements.• Partner. Collaborate with administrators, physicians and front-line staff in
problem-solving efforts.• Execute. Provide support and manage change during the
implementation. • Follow up. Keep in ongoing contact to sustain success.
-- David Kay of DBKay & Assoc.
![Page 28: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/28.jpg)
© E-WRITE 2012 28
Three guidelines for writing concisely
1. Edit for relevance first and brevity second
2. Keep paragraphs short and focused– About five sentences or 75 words– Easily recognized as a chunk– On one topic
3. Use plain, simple language
Too Fancy Nice ‘n Plain
Utilize Use
At the present time Now
As per your request As you requested
![Page 29: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/29.jpg)
How do I get quality content out of these people? Either they can’t write or they don’t want to …
© E-WRITE 2012 29
![Page 30: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/30.jpg)
Today’s “how to get good content out of other people” topics
1. Use before-and-after examples to illustrate web writing principles
2. Refuse to publish web content that’s just not well written
3. Use the wealth of new plain language resources
© E-WRITE 2012 30
![Page 31: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/31.jpg)
Library of Congress FAQs - before
© E-WRITE 2012 31
![Page 32: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/32.jpg)
Library of Congress FAQs - after
© E-WRITE 2012 32
![Page 33: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/33.jpg)
NIEHS Aflatoxin - before
© E-WRITE 2012 33
![Page 34: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/34.jpg)
NIEHS Aflatoxin - after
© E-WRITE 2012 34
![Page 35: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/35.jpg)
Use before-and-after examples to illustrate web writing principles • Examples make principles concrete• Examples enable people who lack content
lingo to participate in content discussions and take responsibility for their content
• Examples enable people to gauge how much work is involved in rewriting their content instead of freaking out
• Examples are a natural resource in the plain language community – collect them!
© E-WRITE 2012 35
![Page 36: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/36.jpg)
As a plain language advocate, should you refuse to publish this content?
© E-WRITE 2012 36
![Page 37: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/37.jpg)
When to refuse to publish web content that’s just not well written • No one will agree to own the content
• The links are broken
• The content is inaccurate, noncompliant, or inconsistent with your organization’s role or mission
• A well-written version exists
• It’s causing problems in the bricks-and-mortar world
© E-WRITE 2012 37
![Page 38: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/38.jpg)
Use the wealth of new plain language resources• Events
• Organizations
• Content style guides
• Writing standards
• Plain language examples
© E-WRITE 2012 38
![Page 39: Well-Written Web Content: Even When It’s Not Your Job, It’s Your Responsibility Leslie O’Flahavan, E-WRITE @LeslieO PLAIN November 14, 2012](https://reader030.vdocument.in/reader030/viewer/2022032722/56649ce45503460f949b0ba2/html5/thumbnails/39.jpg)
Questions? Comments?
Contact info:
Leslie O’Flahavan, E-WRITE
301-989-9583
www.ewriteonline.com
@LeslieO
www.linkedin.com/in/leslieoflahavan
© E-WRITE 2012 39