I already bought the thing, and I’m only looking in the manual because I can’t figure out what’s wrong with the non-working piece of junk, so I don’t really want to read a chipper note congratulating me on my purchase.
People hate reading instructions, and will only glance at them after they are already frustrated and behind schedule. Write for busy grouches who want to jump directly to the section that they think will help them solve their specific problem. (Omit the warm and fuzzy introductions.)
This document introduces five basic principles about writing instructions. Any professional writing textbook will have a long section on writing how-to guides, checklists, and manuals, but the basics are:
Similar:
PAC-MAN: The Untold Story of How We Really Played the Game
A fascinating study of the thinginess of...
Aesthetics
ChoiceScript tutorial for making casual, phone-friendly, stats-driven storygames. Choice o...
https://www.youtube.com/playlist?lis...
Academia
In "World Drama" I'm adding the absurd, optimistic "The Skin of Our Teeth" (dropping bleak...
In light of current events, I'm droppi...
Academia
Stage Right's "The Secret Garden": Performing with My Talented Daughter
This weekend has been magical. Frida...
Culture
Kinetic Theatre's "Hound of the Baskervilles" was hilarious.
Kinetic Theatre's production was ful...
Books
Confessions of a Former Bastard Cop
Medium is not a peer-reviewed source, an...
Culture




Pingback: Asking a Girl on a Date -- Jerz's Literacy Weblog (est. 1999)