Chapter 6

Honing the Tone

IN THIS CHAPTER

Bullet Keeping it short and simple

Bullet Accentuating the positive

Bullet Using contractions (or not)

Bullet Loving the active voice

Bullet Using diverse and inclusive terms

Bullet Being clear and consistent

Bullet Defining terms and acronyms

Bullet Knowing when to avoid jargon

Get human! Stop trying to speak in a monolithic, generic voice. It’s incredibly difficult to write that way, and it’s even more excruciating to have to read that kind of content. Why make things hard for yourself and your audience? Just write clearly, in human terms… No one believes a monolithic voice, so it undermines your credibility.

—AMY GAHRAN, MEDIA CONSULTANT

Learners aren’t tone deaf. They “hear” the subtleties of ...

Get Technical Writing For Dummies, 2nd Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.