A recent article in The Register criticized Google’s Eric Schmidt for, among other things, his (lack of) ability as a technical writer. Since this blog is mainly about expository writing, of which technical writing is a subset, I feel a need to share. Here’s the passage I’m referring to:
…Schmidt goes on to show he’s not conversant with the gentle art of technical writing with procedures that use inconsistent verbs, fail to open each step of a procedure with an active verb and make assumptions that lead to user-befuddling ambiguities.
Gentle art, eh? I’m flattered. Eric’s instructions are too long to quote here (you can find a link them in the article), but the criticisms mentioned in the quote above are worth noting for your own writing.
Inconsistent verbs…active verb. I’m not sure what the writer is referring to here, but when you write instructions, you should use the imperative. Do not say “Please.” Give one instruction per step. Tell the result of following the instruction correctly. (Do not write the result as a separate step!)
User-befuddling ambiguities. Ambiguity is the bane of technical writing. You should write so your material is interpreted exactly one way. Have someone follow your instructions. If they get something wrong, fix the writing. Do not whack the person upside the head for being stupid.
Tech writing has a lot more features, and I saw several other tech writing mistakes in Eric’s material, but I won’t go into them here.
Now in Eric’s defense, he is not a technical writer. He’s an extremely successful businessman with lots of money. (Warning: shameless plug ahead) If his intent is to write a good set of instructions (and not a marketing piece disguised as tech writing) maybe he should hire (ahem) a good technical writer to write the instructions for him.