Writing manuals that inspire

Teaching people how to fix electronic devices and keeping these out of landfills is the ambitious goal of the user community iFixit. The key to this are interesting and exciting manuals. Most recently, the organization published a handbook on how to write such manuals. Here is an excerpt.

Text by Julia Bluff

Inhaltsübersicht

Writing manuals that inspire

Image: © Sergey Nivens/ 123rf.com

So, you’ve decided to write a manual. We extend our hand in hearty congratulations of the do-it-yourself moxie that led you here. Welcome to the world of technical communication!

Now, at this very moment, you may be chuckling to yourself, “Technical communication … Isn’t that an oxymoron?”

We get it. Bad manuals happen … a lot. It’s a universal experience: You take Junior’s Christmas gift out of the box, crack open the assembly manual, and, suddenly, everything goes horribly, horribly wrong. Three hours later, all you have to show for your effort is a mutant tricycle. Junior will not be pleased.

The best way to learn something is to have an expert teach you. But manuals are the next best thing. Great manuals, like the ones from iFixit or Mackie, are teachers.

Manuals are important. Whether you’re writing about how to perform maintenance on a CNC machine, use video editing software, ...