Just Funnin’ – the infamous “Cowboys” section of the Lucid book
billwadge.wordpress.com
billwadge.wordpress.com
The cowboys, the wizards, the preachers, the boffins... They all have valid points covering different aspects of the problems we have to solve in the real world. They all have their place, and the pragmatic engineer evaluates them without prejudice in order to find a reasonably good solution to the problem at hand while keeping things decently clean (or cleanable) for the future.
Like in everything else, there are best practices, and these best practices evolve over time because it's a complicated subject that none of the competing schools of thought have mastered completely within their domain.
I for one celebrate the cross-pollination.
To use a new language you must change your brain.
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.
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.
1. Provides some pedagogic purpose (such as illustrating a point)
2. It's actually funny