Post History

Source: https://writers.stackexchange.com/a/29967
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/

Source: https://writers.stackexchange.com/a/29967
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/

Just don't. Unless you are writing one of those nutty Dummies books, don't put emotion of humor in a technical book.

The reason is not that technical subjects aren't funny or that technical people don't have a sense of humor, it is that audience selection is different for technical books than for other kinds of writing.

For a novel or an essay or even a history, the reader selects the book in large part based on the writing, whether they like the way the author writes or not. In other words, they primarily select the writer. If you decide to tell jokes or show emotions, you will attract readers who like those things. If you are serious, you will attract readers who like serious, and all that is perfectly fine.

But readers of technical books do not choose the book based on its author. They choose it based on its subject matter. The readership is the set of people who care about its subject and that will include people with no sense of humor and people who don't agree with your emotional reactions to things. If you put those things into your technical book, you will be actively hindering those readers from getting the information they came for. This is why most technical books are written very plainly. Because it is not about the writing, it is about the subject matter.

There are exceptions, of course, like the dummies books, but those books are written about very popular subjects for which there are already many books available. Therefore they _can_ segment the readership by the style of writing they prefer and it does become about the writer again.

Original score: 6