Fix This Writing! Jed’s Customer Email
|

Fix This Writing! Jed’s Customer Email

The terrific Leslie O’Flahavan, owner of E-WRITE, and I recently held our first LinkedIn Live broadcast of Fix This Writing! Two Experts Show How to Make Bad Writing Better. Watch the recording and view the writing we discussed below. The idea behind our broadcast is to take an example of not-very-good writing, explain why it’s…

You want to explain first. But should you keep readers waiting for your point?
| |

You want to explain first. But should you keep readers waiting for your point?

If you’re writing to readers from Western cultures, don’t make them wait! Western attention spans are short. We value efficiency–most of the time. But I need to explain when efficiency is (and isn’t) paramount to offer helpful guidance. Here’s my point in this post: Delay only if your point meets all the following criteria for…

What’s “executive” about an executive summary?
|

What’s “executive” about an executive summary?

When a business professional needs to influence other people to do something not obviously beneficial to them, the pro often writes a document designed to persuade those people. That’s why we have proposals, business plans, recommendation reports, white papers, etc. Because those documents present complex information, they are often lengthy. But readers are busy! So…

Save time and avoid frustration during content collaborations
|

Save time and avoid frustration during content collaborations

Here are some common workplace issues that are one focus for my technical editing students this week. Content Collaboration #1 You’ve just started work on a document and are gathering information to include from several individuals who represent different departments at your organization. You get a response from three individuals. Individual A suggests deleting an…

Style Standards for Technical Writing
|

Style Standards for Technical Writing

I’m back (after an extreme hiatus from blogging). Because I’m teaching a new graduate course on style for technical writers, I thought I’d share some of the content I’ve been developing here. If you’d rather watch/listen than read, here’s my 19-minute lecture. Should professional technical communicators still care about writing style? Despite the fact that…

Grades for content quality from federal agencies

Grades for content quality from federal agencies

Since 2010, the Center for Plain Language annually judges the quality of content produced by US government agencies. The results for 2017 are shown below. I love these report cards for several reasons but chief among them is that they use an evidence-based approach. On a shoestring budget. Most complaints about content quality are vague. But the…

Shibboleths & White Shoes: 5 Lessons for Editors
| |

Shibboleths & White Shoes: 5 Lessons for Editors

This post is a response to comments from readers about my use of “insure” in Editors insure content matches audience readiness for it. I’m using this as a teaching moment for my technical editing students so it might be too long for others. Skip ahead if you just want to get to shibboleths or white…