3 ms·

While the text here doesn't strike me as too egregious, compared to some that I've encountered, I admit that I hate it when technical book authors attempt a fol

While the text here doesn't strike me as too egregious, compared to some that I've encountered, I admit that I hate it when technical book authors attempt a folksy, light-hearted, jokey style. Why? Perhaps I'm just a curmudgeon and grouchy old git, but most technical book humour comes across, to me, as puerile, stale, and flat. Case in point? The Little Schemer. I really wanted to like this book, but the insufferably twee cartoons and food-related jokes just annoyed me to the point where I just couldn't go on with it. Remember "This space reserved for jelly stains"? Why? Why would you, as someone trying to explain a difficult technical subject, write something like that? So this book has been thrown in the "sell" pile, as I'll not bother with it again. The best technical books I've read all have a style that could be called plain, unadorned, and direct. And I believe they're much the better for it.

drcode 6y ago
The "schemer" books have pretty much the highest code-to-text ratio of any technical book ever written, so it seems strange to me to complain that they have too many jokes as filler.
- Jtsummers 6y ago
  Indeed. Those books don't have much fluff. Most of it exists at the intro and outro to chapters. I think it's important to consider how they are meant to be used. More than many other books, the Schemer books come across as a dialog with the reader, not just a block of text to read and incorporate (somehow) into your mind. (Of course, this is deliberate and discussed in the books themselves.) Things like the "space reserved for jelly stains" are meant as break points for readers. It's not intended (unless you're already advanced to the point the book has little new to tell you) for readers to go straight through. Just like we don't take college course lectures and run through them in a week (16 weeks, 3 hours/week, 48 total hours, approximately). Doing that would be overwhelming, just like reading one of these books straight through. And it eliminates the time needed to let information and ideas properly integrate into your mind. It's the difference between a cram course and a chance to actually learn.
chris_wot 6y ago
why's (poignant) Guide to Ruby is a delight to read.
NextHendrix 6y ago
In most cases I'd agree but an excellent example of how it can work is in Expert C Programming: Deep C Secrets By Peter van der Linden. It manages to be both technically dense and hilarious, the tongue in cheek style does well to contrast the fairly mundane subject matter.
sgt101 6y ago
This is good for you - but there are people out there who have a different learning style and maybe there's a place for those texts to help them?
cainxinth 6y ago
I'm fine with adding a little humor and levity in a technical book, but only if the following conditions are met: 1. Provides some pedagogic purpose (such as illustrating a point) 2. It's actually funny

drcode 6y ago

The "schemer" books have pretty much the highest code-to-text ratio of any technical book ever written, so it seems strange to me to complain that they have too many jokes as filler.

Jtsummers 6y ago
Indeed. Those books don't have much fluff. Most of it exists at the intro and outro to chapters. I think it's important to consider how they are meant to be used. More than many other books, the Schemer books come across as a dialog with the reader, not just a block of text to read and incorporate (somehow) into your mind. (Of course, this is deliberate and discussed in the books themselves.) Things like the "space reserved for jelly stains" are meant as break points for readers. It's not intended (unless you're already advanced to the point the book has little new to tell you) for readers to go straight through. Just like we don't take college course lectures and run through them in a week (16 weeks, 3 hours/week, 48 total hours, approximately). Doing that would be overwhelming, just like reading one of these books straight through. And it eliminates the time needed to let information and ideas properly integrate into your mind. It's the difference between a cram course and a chance to actually learn.

chris_wot 6y ago

why's (poignant) Guide to Ruby is a delight to read.

NextHendrix 6y ago

In most cases I'd agree but an excellent example of how it can work is in Expert C Programming: Deep C Secrets By Peter van der Linden. It manages to be both technically dense and hilarious, the tongue in cheek style does well to contrast the fairly mundane subject matter.

sgt101 6y ago

This is good for you - but there are people out there who have a different learning style and maybe there's a place for those texts to help them?

cainxinth 6y ago

I'm fine with adding a little humor and levity in a technical book, but only if the following conditions are met: 1. Provides some pedagogic purpose (such as illustrating a point) 2. It's actually funny