There are no Prerequisites

There are few worse ideas in technical communication than the idea that procedures have prerequisites. There are no prerequisites. There are only steps.

To illustrate: Last weekend I paid a visit to some family members who were camping at a nearby campground. They were struggling to inflate the new air mattress they had bought. The mattress had an integrated foot pump, but no matter how they pumped, the mattress refused to fill with air.

Several of us took our turns trying. Each of us read the instructions and did what they said to do, all to no effect. The decision was eventually made to return the mattress to the store, and discussion turned to whether to go home or sleep on the ground. read more

Tech Writers Must Learn to Stage Content Better

Some technical writers are proud of the utilitarian nature of their content. This isn’t marketing, they will say, with no attempt to veil their contempt for anything that might please or persuade. The customer has already bought the product, they will explain, so there is nothing left to sell.

This is wrong on a number of counts.

Documentation has to sell

There is a lot left to sell after the user makes an initial purchase. There are more copies to sell across the user’s organization. There is the next version to sell. There are other products your company wants to sell. There are the people that each current customer influences that your company want’s to sell to. But even more basic than this, your content has to be sold to the user. True, you are not asking the user for cash; just for time and trust. But time and trust are currency, and if we cannot command the reader’s time and trust, how can we expect to command our salaries? read more