The pleasure of a manual that works

I read instruction manuals for pleasure, and I have stopped apologising for it.

Not the ones nobody wrote, the fifty page warranty booklets that come with a kettle and tell you not to use it in the bath. I mean the good ones. The single folded sheet inside the box of a bicycle pump that explains, in nine steps and four small drawings, exactly how a thing you have never held before is meant to work. There is a happiness in a manual like that which I have never once got from a book that promised to change my life, and I have come to think it is the happiness of being trusted to follow along.

A good manual assumes you are neither a fool nor an expert. It does not flatter you and it does not talk down. It tells you everything you will need before you begin, so that you are not halfway in with your hands full and one small screw rolling somewhere under the fridge. It names the parts, and it uses the same name in the drawing and in the paragraph, which sounds like nothing until you have wrestled with a manual that calls a thing a bracket on the first page and a mounting plate on the third. It gives you the steps in the order you will actually do them, not the order that was easiest to print.

I put together a flat pack wardrobe a few weekends ago, the kind that arrives as a coffin of chipboard and a bag of hardware with no obvious top or bottom. The sheet inside was a small masterpiece. It counted the screws for me at the start. It told me which panel was the back before I could get it wrong, and it was right about the one step where I would be tempted to hurry and should not. An hour later there was a wardrobe, and no leftover pieces sitting on the floor accusing me of something.

I keep thinking about why that felt so good, and I have decided it is not really about furniture.

A page of science fiction is a manual for a world that does not exist. The reader has never been to the station. They have not seen the drive, they have not met the crew, they do not know which door leads outside and which leads to the mess. Everything they will ever know about the place, they will get from me, one sentence at a time. So the rules a good manual follows are the rules I try to write by. If I call a thing a bracket on page one, I do not get to call it a mounting plate on page two. If the reader will need to know how the airlock cycles, I tell them once, plainly, before the moment it matters, so that when the moment comes their hands are not full.

Clarity gets no awards. Nobody finishes a chapter and marvels that they understood it. But being understood is the whole job, in a manual and on the page both, and the writer who manages it is doing something quietly generous: getting out of the way, and trusting you to follow along.