Go offline with the Player FM app!
Skill #9: Creating a Human Connection in Your Documentation
Manage episode 245800931 series 2568080
We’ve all read (and perhaps written) a boring document: the robot-like language, the walls of text. And we’re all familiar with the result: a disengaged reader who’s likely missed the message.
Enter John Espirian, freelance technical writer and Director at the Society for Editors and Proofreaders.
John believes the difference between a boring and a not-boring document comes down to one essential element: a human connection.
In this episode, John shares how you can create that human connection in your documentation, including:
- how to better understand your end-users.
- why your documentation tone must match the brand.
- what simplicity means (and doesn’t mean).
Show Notes:
- Pen Portraits
- John Espirian (Twitter) (LinkedIn) (Facebook)
- John’s site
57 episodes
Manage episode 245800931 series 2568080
We’ve all read (and perhaps written) a boring document: the robot-like language, the walls of text. And we’re all familiar with the result: a disengaged reader who’s likely missed the message.
Enter John Espirian, freelance technical writer and Director at the Society for Editors and Proofreaders.
John believes the difference between a boring and a not-boring document comes down to one essential element: a human connection.
In this episode, John shares how you can create that human connection in your documentation, including:
- how to better understand your end-users.
- why your documentation tone must match the brand.
- what simplicity means (and doesn’t mean).
Show Notes:
- Pen Portraits
- John Espirian (Twitter) (LinkedIn) (Facebook)
- John’s site
57 episodes
All episodes
×Welcome to Player FM!
Player FM is scanning the web for high-quality podcasts for you to enjoy right now. It's the best podcast app and works on Android, iPhone, and the web. Signup to sync subscriptions across devices.