Skill #9: Creating a Human Connection in Your Documentation

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).