I bought some small appliance and a folded sheet of paper fell out of the box. The front page, in large type, said: Do not place in a damp environment. On the back, under item seven of the cautions, was the sentence that actually mattered: run the unit empty for two minutes before first use.
I stood there looking at that sheet. What I was thinking about was not the machine but the person who wrote it.
The instruction manual may be the most awkward of all genres. Nobody wants to write one, nobody wants to read one, and both sides are trying to get it over with. Which is why the usual arrangement is this: the warning you need is buried in the least visible spot, and the warning that does nothing (do not use for purposes not listed in this manual) is printed where your eye lands first. This is not carelessness. It is a tacit agreement — the author assumes you already know how, and writes only to cover himself; you assume you don’t need to read it, and open it only to prove that you don’t need to.
Whether a manual is any good has little to do with its wording and everything to do with who its imagined reader is. A bad manual assumes a practiced hand that needs one line of confirmation. A good one assumes a reader who knows nothing, is already annoyed, and is holding a screwdriver.
I have met two opposite approaches. The first is wordless: a few line drawings, numbered parts, arrows. It spares the trouble of translation and looks clean. But nowhere in those drawings does it say what happens if you fit the piece in backwards, so mistakes happen anyway, and the reader pays the cost of taking it apart again. The second approach is clumsy to the point of stupidity: step one is not assembly but “remove all parts from the packaging, lay them out as shown, and count them.” That clumsy step is worth money, because it admits something on your behalf: right now you are in a mess, and you don’t know what is missing.
A third approach is the rarest: a section at the end titled “If it won’t go together.” It assumes you will fail, and it does not count your failure as your fault. Only someone willing to write the troubleshooting page is really on your side, because that is the one page no author can copy. He has to have actually watched people get stuck.
Deeper still, the difficulty of writing a manual is not technical but mnemonic. Whoever writes it has long since forgotten what it was like not to know. And that forgetting is nearly irreversible: once you can do a thing, the steps merge, judgment becomes reflex, and looking back you can only say, “isn’t it obvious?” So the best manual writers are rarely the greatest experts. They are the people who learned recently and are still carrying the wound. A wound remembers the order.
Song Yingxing illustrated every process in his seventeenth-century survey of crafts, Tiangong Kaiwu. His readers were artisans, many of them barely literate, and pictures served them better than prose. I have always admired this: he was not lowering the knowledge, he was adjusting the posture of the handover until the other person could actually take hold of it. Willingness to change posture for the reader — that is what wanting someone to learn looks like.
And it is not only manuals. All writing that teaches has this flaw. The person teaching you to cook writes “a suitable amount,” because he has never once measured. The person teaching you to write says “read more and write more,” because he cannot say how he himself reads. Neither statement is false. They simply fail to hand anything over. They describe the state of knowing, not the road from not knowing.
I judge a manual now by one crude test: when I finish, would I keep it? A good one goes into a drawer, because you know you will need it again. A bad one goes into the bin on the spot and has nothing more to do with the machine. You keep it not because the paper is well printed, but because you believe the person who wrote it thought about your later.
In the end I did run the thing empty for two minutes. Not because I trusted the sheet, but because when I reached that line it occurred to me that whoever wrote it had probably once stood in a kitchen too, in front of a new machine, afraid of breaking it.
卜世 撰

说些什么吧!