-image-Harder than it looks
Posted October 11th, 2005 by paul.
Category: Better Living, General/Random, Technical Writing | 3 Comments »
(Another episode in the “Better Living by Doing It Yourself” series)
Writing good instructions is hard. I feel qualified to make that assertion because it is what I do every day for a living. So I just wanted to start off this story by saying that I recognize that as an instruction writer, it is hard to anticipate all possible problems your users might encounter when they are attempting to use your product.
However, this week I had a set of instructions that failed miserably for me. This was due, in part, (probably) to user error, but this user error occurred because the instructions were neither clear nor complete. (I will give it credit, however, for good warnings like: “If you breathe the fumes from this product, contact poison control and see a medical professional” and “if you come in contact with this product, rinse well for 20 minutes, then contact a medical professional.” Oh, and there was the one about using gloves and a face mask when using this product. See, those are good warnings!)
Anyway, here is what happened…
Read the rest of this entry »
(Another episode in the “Better Living by Doing It Yourself” series)
Writing good instructions is hard. I feel qualified to make that assertion because it is what I do every day for a living. So I just wanted to start off this story by saying that I recognize that as an instruction writer, it is hard to anticipate all possible problems your users might encounter when they are attempting to use your product.
However, this week I had a set of instructions that failed miserably for me. This was due, in part, (probably) to user error, but this user error occurred because the instructions were neither clear nor complete. (I will give it credit, however, for good warnings like: “If you breathe the fumes from this product, contact poison control and see a medical professional” and “if you come in contact with this product, rinse well for 20 minutes, then contact a medical professional.” Oh, and there was the one about using gloves and a face mask when using this product. See, those are good warnings!)
Anyway, here is what happened…
Read the rest of this entry »



