Skip to main content
Technical Writing

Technical writing Q&A with workshop expert Julia Bluff.

8 Questions View all
User avatar

Can you use humor to point out the absurdity of instructions?

Sometimes the technology and processes I write about are silly. It it OK to acknowledge that you recognize this to the reader?

Answer this question I have this problem too

Is this a good question?

Score 1
Add a comment

1 Answer

Most Helpful Answer
User avatar

Humor is a matter of style, and style should be fairly consistent from doc to doc. But I actually love humor in technical writing, because I think that humor (done well) is a great way to make something memorable. Make someone laugh unexpectedly, and they'll remember it. Humor is engaging—and when you're writing about dry topics, finding ways to keep the audience engaged is half the battle.

You certainly can go overboard with humor, though. And unless you have a natural flair for jokes, it can be genuinely hard to write funny material (force the joke, and you kill the joke). As always with writing, it's a balancing act. Mackie, by the way, is really good at balancing information, instruction, and humor in their product manuals. I'd look to them for a good reference.

Was this answer helpful?

Score 2
Add a comment

Add your answer

Author avatar Dennis Bishop will be eternally grateful.