Posts

User Manual

One of the most common myths about technical documentation is that nobody reads it. Let’s talk about this myth and four big reasons why you shouldn’t believe it.

Most of us can’t honestly say that we learned how to use a television or computer by studying a reference manual. And the Internet — that didn’t come with a user manual, either. So it’s worth asking: who actually reads user manuals?

First, let’s suppose that computer software or hardware ideally ought to be so well designed that users do not need to consult the online help or printed manuals.

This is not an argument for laying off technical writers, but for involving them earlier in the design process whenever possible as advocates for an excellent user experience. Too often technical writers are only hired after software design is done, so that they have less of an opportunity to improve the products.

It is also worth pointing out that reality falls well short of this ideal, especially when dealing with new and innovative products. As much as we would wish it, technology products are rarely self-documenting. They may seem that way to their designers and developers, but only because over familiarity produces a sort of spell on them.

Read more