Writing for the Web

Jeffrey Levy
Jeffrey LevyDirector, Global Web Platforms
Writing for the Web
May 2013
Key Points
• Less is more: cut half of the text, then cut again
• Make it immediately clear why this is useful
• Don’t wander from the page’s purpose
• Make it scannable:
– Use good headings
– Use lists as much as possible
• Be direct: use readers’ words and active voice
• Link using text that’s clear about the destination
• Make text timeless
Passive Voice Obscures
• Applications must be submitted
• A decision will be issued
• Upon completion of the process
Use Direct, Short Phrases
• No
– At the present time
– In the current location
– Your examples?
What’s Easier to Read?
Link Tips
• Link using text that’s clear about the destination
• Make the file type clear if the link isn’t a Web page
• Use unique links
• No:
– Phones & plans
– Smartphones & apps
• Start sentences with the link, not the sentence. Add
explanatory surrounding text only if necessary.
Link Text
• Examples of poor link text
– Read more
– Click here
• Examples of good link text
– Fact Sheet: Background information on the FDA/EPA Consumer Advisory
on Mercury in Fish and Shellfish
– Technical Memorandum: Origin of 1 meal / week Freshwater Fish
Consumption Rate (PDF)
– Climate Change in the Pacific Southwest (Instead of Read more…)
Link Tips cont.
• Make links scannable with unique beginnings
• No:
– How to install a router
– How to install your server software
– How to install your browser software
• Yes:
– How to install:
• Router
• Server software
• Browser software
Scannable Links - NOT
Better
Improving the content
• Pesticides are one component (better word: part) of a comprehensive strategy for controlling
bed bugs. Currently, there are over 300 products registered by EPA for use against bed
bugs – the vast majority (better word: many) of which can be used by consumers. Several
classes of chemicals are utilized in these products -- each class share a similar mode of
action, or way in which the chemical affects the biological functions of a bed bug.
• To help you find a product, EPA has developed a Bed Bug Product Search tool to help you
find a product that meets your needs.
• If you find that a particular chemical treatment seems to be ineffective (better phrase: didn’t
work) , please read When Treatments Don’t Work before reapplying or trying a different
product. You may want to consult (better word: ask) a pest management professional to
inspect your residence (better word: home) and, if needed, apply approved pesticides to
treat any infestation. For assistance (better word: help) with choosing a pesticide registered
for consumer use, you may also check with the Cooperative Extension Service office in your
area.
Content not related to audience
• The economic
impact doesn’t
matter to the person
(or caregiver) who
wants to avoid an
episode of COPD
Content not related to audience
• Lots of people have it.
The stats don’t add
value for the audience.
• Two sets of symptoms
makes it unclear.
Make Text Timeless
• Avoid dating words
– Today
– This year
– Last month
• Use years, specific dates, even on the day you
publish, with past tense
– On May 2, 2013 …
– In 2012, we …
Resources
• EPA requirements:
http://www2.epa.gov/webguide/writing-web-
requirements
• Howto.gov: http://www.howto.gov/web-
content/manage/write-for-the-web
1 of 15

Recommended

Reed Library Comp 250 Presentation for Spring 2017 by
Reed Library Comp 250 Presentation for Spring 2017Reed Library Comp 250 Presentation for Spring 2017
Reed Library Comp 250 Presentation for Spring 2017Ginger Williams
294 views30 slides
Free Social Media Monitoring Dashboard by
Free Social Media Monitoring DashboardFree Social Media Monitoring Dashboard
Free Social Media Monitoring DashboardThe @Steveology Group
6.9K views39 slides
Searching For Articles Using an Article Database by
Searching For Articles Using an Article DatabaseSearching For Articles Using an Article Database
Searching For Articles Using an Article DatabaseMSVUlibrary
37 views24 slides
On the value of evidence based learning by
On the value of evidence based learningOn the value of evidence based learning
On the value of evidence based learningScott Armstrong
65 views4 slides
Public Speaking Super Powers by
Public Speaking Super PowersPublic Speaking Super Powers
Public Speaking Super Powersreardond2
287 views17 slides
Public Speaking Super Powers by
Public Speaking Super PowersPublic Speaking Super Powers
Public Speaking Super Powersreardond2
97 views17 slides

More Related Content

Similar to Writing for the Web

Healthy human nutrition.docx by
Healthy human nutrition.docxHealthy human nutrition.docx
Healthy human nutrition.docxsdfghj21
2 views2 slides
MRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docx by
MRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docxMRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docx
MRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docxveachflossie
5 views3 slides
Application of EBP spread to allied health professions.pdf by
Application of EBP spread to allied health professions.pdfApplication of EBP spread to allied health professions.pdf
Application of EBP spread to allied health professions.pdfstudywriters
2 views3 slides
S. White 1 Nonprofit Sector Ethics and Accountabili.docx by
S. White 1  Nonprofit Sector Ethics and Accountabili.docxS. White 1  Nonprofit Sector Ethics and Accountabili.docx
S. White 1 Nonprofit Sector Ethics and Accountabili.docxjeffsrosalyn
2 views39 slides
S. White 1 Nonprofit Sector Ethics and Accountabili by
S. White 1  Nonprofit Sector Ethics and AccountabiliS. White 1  Nonprofit Sector Ethics and Accountabili
S. White 1 Nonprofit Sector Ethics and AccountabiliMalikPinckney86
2 views39 slides
InstructionsOne of the many tasks involved in writing a disserta.docx by
InstructionsOne of the many tasks involved in writing a disserta.docxInstructionsOne of the many tasks involved in writing a disserta.docx
InstructionsOne of the many tasks involved in writing a disserta.docxcarliotwaycave
10 views407 slides

Similar to Writing for the Web(20)

Healthy human nutrition.docx by sdfghj21
Healthy human nutrition.docxHealthy human nutrition.docx
Healthy human nutrition.docx
sdfghj212 views
MRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docx by veachflossie
MRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docxMRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docx
MRKT 310 Principles of MarketingWeek 3 Writing AssignmentConsume.docx
veachflossie5 views
Application of EBP spread to allied health professions.pdf by studywriters
Application of EBP spread to allied health professions.pdfApplication of EBP spread to allied health professions.pdf
Application of EBP spread to allied health professions.pdf
studywriters2 views
S. White 1 Nonprofit Sector Ethics and Accountabili.docx by jeffsrosalyn
S. White 1  Nonprofit Sector Ethics and Accountabili.docxS. White 1  Nonprofit Sector Ethics and Accountabili.docx
S. White 1 Nonprofit Sector Ethics and Accountabili.docx
jeffsrosalyn2 views
S. White 1 Nonprofit Sector Ethics and Accountabili by MalikPinckney86
S. White 1  Nonprofit Sector Ethics and AccountabiliS. White 1  Nonprofit Sector Ethics and Accountabili
S. White 1 Nonprofit Sector Ethics and Accountabili
MalikPinckney862 views
InstructionsOne of the many tasks involved in writing a disserta.docx by carliotwaycave
InstructionsOne of the many tasks involved in writing a disserta.docxInstructionsOne of the many tasks involved in writing a disserta.docx
InstructionsOne of the many tasks involved in writing a disserta.docx
carliotwaycave10 views
8 Tips to make your health website easier to use by Ana Tellez
8 Tips to make your health website easier to use8 Tips to make your health website easier to use
8 Tips to make your health website easier to use
Ana Tellez583 views
Keyword Optimization Guide - ASO and App Store Marketing by Michelle Núñez
Keyword Optimization Guide - ASO and App Store MarketingKeyword Optimization Guide - ASO and App Store Marketing
Keyword Optimization Guide - ASO and App Store Marketing
Michelle Núñez1.6K views
How to Make the Web Easier for Users with Limited Literacy Skills - Sandy Hil... by UXPA International
How to Make the Web Easier for Users with Limited Literacy Skills - Sandy Hil...How to Make the Web Easier for Users with Limited Literacy Skills - Sandy Hil...
How to Make the Web Easier for Users with Limited Literacy Skills - Sandy Hil...
UXPA International 1.3K views
Annotated Bibliography Cholera.docx by 4934bk
Annotated Bibliography Cholera.docxAnnotated Bibliography Cholera.docx
Annotated Bibliography Cholera.docx
4934bk3 views
Trace the history of cannabis use in medicine.docx by write4
Trace the history of cannabis use in medicine.docxTrace the history of cannabis use in medicine.docx
Trace the history of cannabis use in medicine.docx
write42 views
Advanced literature searching by sarahvr10
Advanced literature searchingAdvanced literature searching
Advanced literature searching
sarahvr10111 views
Embase: Tips and tricks for trainers - Webinar, 27 Nov 2013 by Ann-Marie Roche
Embase: Tips and tricks for trainers - Webinar, 27 Nov 2013Embase: Tips and tricks for trainers - Webinar, 27 Nov 2013
Embase: Tips and tricks for trainers - Webinar, 27 Nov 2013
Ann-Marie Roche3.8K views
PART AComplete the Process Design Matrix.Develop a 700-word .docx by danhaley45372
PART AComplete the Process Design Matrix.Develop a 700-word .docxPART AComplete the Process Design Matrix.Develop a 700-word .docx
PART AComplete the Process Design Matrix.Develop a 700-word .docx
danhaley453723 views
Best Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docx by jasoninnes20
Best Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docxBest Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docx
Best Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docx
jasoninnes202 views
Best Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docx by richardnorman90310
Best Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docxBest Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docx
Best Practices for TelehealthALLURA L. RALSTON, M.A.DEP.docx

More from Jeffrey Levy

Coordinating Multiple Social Media Platforms by
Coordinating Multiple Social Media PlatformsCoordinating Multiple Social Media Platforms
Coordinating Multiple Social Media PlatformsJeffrey Levy
595 views23 slides
Using RSS to Post Jobs to Multiple Channels by
Using RSS to Post Jobs to Multiple ChannelsUsing RSS to Post Jobs to Multiple Channels
Using RSS to Post Jobs to Multiple ChannelsJeffrey Levy
10.4K views28 slides
Crisis Communications Online: Web and Social Media by
Crisis Communications Online: Web and Social MediaCrisis Communications Online: Web and Social Media
Crisis Communications Online: Web and Social MediaJeffrey Levy
1.3K views20 slides
Handout: Mission, Tool, Metrics, Teach by
Handout: Mission, Tool, Metrics, TeachHandout: Mission, Tool, Metrics, Teach
Handout: Mission, Tool, Metrics, TeachJeffrey Levy
685 views2 slides
Facetweeting: How To and Lessons Learned from EPA's Experiences by
Facetweeting: How To and Lessons Learned from EPA's ExperiencesFacetweeting: How To and Lessons Learned from EPA's Experiences
Facetweeting: How To and Lessons Learned from EPA's ExperiencesJeffrey Levy
767 views22 slides
From 30,000 Feet to 3 Feet: Running a Federal Blog by
From 30,000 Feet to 3 Feet: Running a Federal BlogFrom 30,000 Feet to 3 Feet: Running a Federal Blog
From 30,000 Feet to 3 Feet: Running a Federal BlogJeffrey Levy
827 views23 slides

More from Jeffrey Levy(8)

Coordinating Multiple Social Media Platforms by Jeffrey Levy
Coordinating Multiple Social Media PlatformsCoordinating Multiple Social Media Platforms
Coordinating Multiple Social Media Platforms
Jeffrey Levy595 views
Using RSS to Post Jobs to Multiple Channels by Jeffrey Levy
Using RSS to Post Jobs to Multiple ChannelsUsing RSS to Post Jobs to Multiple Channels
Using RSS to Post Jobs to Multiple Channels
Jeffrey Levy10.4K views
Crisis Communications Online: Web and Social Media by Jeffrey Levy
Crisis Communications Online: Web and Social MediaCrisis Communications Online: Web and Social Media
Crisis Communications Online: Web and Social Media
Jeffrey Levy1.3K views
Handout: Mission, Tool, Metrics, Teach by Jeffrey Levy
Handout: Mission, Tool, Metrics, TeachHandout: Mission, Tool, Metrics, Teach
Handout: Mission, Tool, Metrics, Teach
Jeffrey Levy685 views
Facetweeting: How To and Lessons Learned from EPA's Experiences by Jeffrey Levy
Facetweeting: How To and Lessons Learned from EPA's ExperiencesFacetweeting: How To and Lessons Learned from EPA's Experiences
Facetweeting: How To and Lessons Learned from EPA's Experiences
Jeffrey Levy767 views
From 30,000 Feet to 3 Feet: Running a Federal Blog by Jeffrey Levy
From 30,000 Feet to 3 Feet: Running a Federal BlogFrom 30,000 Feet to 3 Feet: Running a Federal Blog
From 30,000 Feet to 3 Feet: Running a Federal Blog
Jeffrey Levy827 views
Social Media And The Gov’t: A Brief Introduction by Jeffrey Levy
Social Media And The Gov’t: A Brief IntroductionSocial Media And The Gov’t: A Brief Introduction
Social Media And The Gov’t: A Brief Introduction
Jeffrey Levy1.6K views
How to Write a Gov't Blog Post by Jeffrey Levy
How to Write a Gov't Blog PostHow to Write a Gov't Blog Post
How to Write a Gov't Blog Post
Jeffrey Levy708 views

Recently uploaded

Crypto Quantum Leap by
Crypto Quantum Leap Crypto Quantum Leap
Crypto Quantum Leap ahmedjaan790
8 views22 slides
2023-11 Managing your Cost of Living and Spending.pptx by
2023-11 Managing your Cost of Living and Spending.pptx2023-11 Managing your Cost of Living and Spending.pptx
2023-11 Managing your Cost of Living and Spending.pptxdmeekis
18 views35 slides
The_5_Love_Languages.pdf by
The_5_Love_Languages.pdfThe_5_Love_Languages.pdf
The_5_Love_Languages.pdffoodcoop1
5 views166 slides
Quotes on self confidence and self belief ppt .pdf by
Quotes on self confidence and self belief ppt .pdfQuotes on self confidence and self belief ppt .pdf
Quotes on self confidence and self belief ppt .pdfInspire99
26 views8 slides
2023-11 Managing your Cost of Living and Spending.pptx by
2023-11 Managing your Cost of Living and Spending.pptx2023-11 Managing your Cost of Living and Spending.pptx
2023-11 Managing your Cost of Living and Spending.pptxdmeekis
12 views35 slides
Romel by
RomelRomel
RomelRomelPacisJr
17 views13 slides

Recently uploaded(7)

2023-11 Managing your Cost of Living and Spending.pptx by dmeekis
2023-11 Managing your Cost of Living and Spending.pptx2023-11 Managing your Cost of Living and Spending.pptx
2023-11 Managing your Cost of Living and Spending.pptx
dmeekis18 views
The_5_Love_Languages.pdf by foodcoop1
The_5_Love_Languages.pdfThe_5_Love_Languages.pdf
The_5_Love_Languages.pdf
foodcoop15 views
Quotes on self confidence and self belief ppt .pdf by Inspire99
Quotes on self confidence and self belief ppt .pdfQuotes on self confidence and self belief ppt .pdf
Quotes on self confidence and self belief ppt .pdf
Inspire9926 views
2023-11 Managing your Cost of Living and Spending.pptx by dmeekis
2023-11 Managing your Cost of Living and Spending.pptx2023-11 Managing your Cost of Living and Spending.pptx
2023-11 Managing your Cost of Living and Spending.pptx
dmeekis12 views
Quotes about hard work .pdf by Inspire99
Quotes about hard work .pdfQuotes about hard work .pdf
Quotes about hard work .pdf
Inspire9915 views

Writing for the Web

  • 1. Writing for the Web May 2013
  • 2. Key Points • Less is more: cut half of the text, then cut again • Make it immediately clear why this is useful • Don’t wander from the page’s purpose • Make it scannable: – Use good headings – Use lists as much as possible • Be direct: use readers’ words and active voice • Link using text that’s clear about the destination • Make text timeless
  • 3. Passive Voice Obscures • Applications must be submitted • A decision will be issued • Upon completion of the process
  • 4. Use Direct, Short Phrases • No – At the present time – In the current location – Your examples?
  • 6. Link Tips • Link using text that’s clear about the destination • Make the file type clear if the link isn’t a Web page • Use unique links • No: – Phones & plans – Smartphones & apps • Start sentences with the link, not the sentence. Add explanatory surrounding text only if necessary.
  • 7. Link Text • Examples of poor link text – Read more – Click here • Examples of good link text – Fact Sheet: Background information on the FDA/EPA Consumer Advisory on Mercury in Fish and Shellfish – Technical Memorandum: Origin of 1 meal / week Freshwater Fish Consumption Rate (PDF) – Climate Change in the Pacific Southwest (Instead of Read more…)
  • 8. Link Tips cont. • Make links scannable with unique beginnings • No: – How to install a router – How to install your server software – How to install your browser software • Yes: – How to install: • Router • Server software • Browser software
  • 11. Improving the content • Pesticides are one component (better word: part) of a comprehensive strategy for controlling bed bugs. Currently, there are over 300 products registered by EPA for use against bed bugs – the vast majority (better word: many) of which can be used by consumers. Several classes of chemicals are utilized in these products -- each class share a similar mode of action, or way in which the chemical affects the biological functions of a bed bug. • To help you find a product, EPA has developed a Bed Bug Product Search tool to help you find a product that meets your needs. • If you find that a particular chemical treatment seems to be ineffective (better phrase: didn’t work) , please read When Treatments Don’t Work before reapplying or trying a different product. You may want to consult (better word: ask) a pest management professional to inspect your residence (better word: home) and, if needed, apply approved pesticides to treat any infestation. For assistance (better word: help) with choosing a pesticide registered for consumer use, you may also check with the Cooperative Extension Service office in your area.
  • 12. Content not related to audience • The economic impact doesn’t matter to the person (or caregiver) who wants to avoid an episode of COPD
  • 13. Content not related to audience • Lots of people have it. The stats don’t add value for the audience. • Two sets of symptoms makes it unclear.
  • 14. Make Text Timeless • Avoid dating words – Today – This year – Last month • Use years, specific dates, even on the day you publish, with past tense – On May 2, 2013 … – In 2012, we …
  • 15. Resources • EPA requirements: http://www2.epa.gov/webguide/writing-web- requirements • Howto.gov: http://www.howto.gov/web- content/manage/write-for-the-web

Editor's Notes

  1. http://cfpub.epa.gov/npdes/docs.cfm?program_id=0&view=allnpdes&sort=name&amount=all