Prose Is Dead. Long Live Prose

0 comments suggest edit

Charlez Petzold makes the following lament in response to Jeff Atwood’s review of two WPF books, one being Petzold’s.

I’ve been mulling over Coding Horror’s analysis of two WPF books, not really thrilled about it, of course. The gist of it is that modern programming books should have color, bullet points, boxes, color, snippets, pictures, color, scannability, and color.

Does that remind you of anything?

Apparently the battle for the future of written communication is over. Prose is dead. PowerPoint has won.

With all due respect to Mr. Petzold, and he certainly deserves much respect, I think the comparison to PowerPoint is unfair and really misses the point.

Since when is technical writing prose?

Well it often does meet one of the definitions of prose.

​1. the ordinary form of spoken or written language, without metrical structure, as distinguished from poetry or verse.\ 2. matter-of-fact, commonplace, or dull expression, quality, discourse, etc.

Using that definition, I fail to see how the death of dull and commonplace expression signals a loss for the future of written communication. If anything, it’s a step in the right direction.

Technical writing is supposed to teach and help readers learn and retain information. Having visual aids not only helps cement the information in your mind, but also aids in finding that information when you need to look it up again.

Long passages of unbroken prose are great for getting lost in mental imagery when reading a novel, but it sucks for recall. Prose is alive and well in its proper place. Save the lengthy prose for the next great work of fiction, but cater to how the brain works when writing something meant to be absorbed, learned, and remembered.

Head First Design Patterns
Cover I think the Head First series really gets it when it comes to how the mind works and learns. From the introduction to Head First Design Patterns.

Your brain craves novelty. It’s always searching, scanning, waiting for something unusual. It was built that way, and it helps you stay alive.

Today, you’re less likely to be a tiger snack. But your brain’s still looking. You just never know.

So what does your brain do with all the routine, ordinary, normal things you encounter? Everything it can to stop them from interfering with the brain’s real job—recording things that matter. It doesn’t bother saving the boring things; they never make it past the “this is obviously not important” filter.

In a subsequent section, the book describes the Head First learning principles, a couple of which I quote below. I highly recommend reading this entire intro the next time you are in the bookstore.

Make it visual. Images are far more memorable than words alone, and make learning much more effective (up to 89% improvement in recall and transfer studies). It also makes things more understandable. Put the words within or near the graphics they relate to, rather than on the bottom or on another page, and learners will be up to twice as likely to solve problems related to the content.

Use a conversational and personalized style. In recent studies, students performed up to 40% better on post-learning tests if the content spoke directly to the reader, using a first-person conversational style rather than taking a formal tone.

What we see here is that studies after studies show that appropriate use of images and graphics improve recall. Not only that, but a casual tone, like that found in a blog, also helps recall.

Unfortunately, Petzold draws an unfair analogy between Adam Nathan’s WPF book and PowerPoint. We’ve all heard that PowerPoint is evil, but the evil is in how users misuse PowerPoint, not PowerPoint itself. PowerPoint certainly makes it easy to go to the extreme with noisy graphics resulting in garish crowded presentations.

It’s this proliferation of PowerPoint presentations that favor graphics to the detriment of the content that leads to the disdain towards PowerPoint. But it is also possible to create sublime presentations with PowerPoint with just the right amount of graphics.

Even Tufte would acknowledge that getting rid of graphics and bullet points completely is also extreme in the opposite direction and works against the real goal, to convey information in a manner that the audience can understand and retain it.

Drawing a comparison between Nathan’s book and PowerPoint suggests that the Nathan’s Book is all fluff and flash. But based on reading sample chapters, that is hardly the case. As Jeff wrote, the graphics, colors, and bullets all are used judiciously and appropriately. This isn’t the case of Las Vegas trying to pretend it is Florence. There’s real substance here.

Found a typo or error? Suggest an edit! If accepted, your contribution is listed automatically here.

Comments

avatar

11 responses

  1. Avatar for pcomeau
    pcomeau April 27th, 2007

    I would also add... the use of color for code examples in Nathan's book is helpfull because it duplicates the enviroment of VisualStudio. I find this usefull because that's the enviroment I'm in and therefore the visual cues I rely on. When i use Eclipse for Java I then expect a different sort of code highlighting and... would then appreciate books that use that.
    So no prose is not dead... and I agree books on technologies like coding frameworks need to be interesting to look at.

  2. Avatar for Scott Hanselman
    Scott Hanselman April 27th, 2007

    TV is dead! All this Full Color HDTV misses the point! I'll stick with my 9" B&W - the way TV was meant to be watched. :)
    Off to watch Perry Mason...

  3. Avatar for Dan
    Dan April 27th, 2007

    I like Petzold's book, as I like Programming Windows in C# that is written in the same style.
    Why now this stupid polemic ?
    When you buy a Petzold's book, you know what you are paying for.

  4. Avatar for Thomas Wagner
    Thomas Wagner April 27th, 2007

    That Head First book is the best book I've seen on the subject. And yes part of it has to do with the way things are explained in it. Its fantastic. Great example!

  5. Avatar for Community Blogs
    Community Blogs April 28th, 2007

    Jeff Atwood recently published a blog entry titled How Now to Write a Technical Book , in which he compared

  6. Avatar for BusinessRx Reading List
    BusinessRx Reading List April 28th, 2007

    Jeff Atwood recently published a blog entry titled How Now to Write a Technical Book , in which he compared

  7. Avatar for Scott Elkin
    Scott Elkin April 28th, 2007

    I absolutely agree with you, Jeff, and now Scott Mitchell.
    However, I would lump the "Head First" books with the overly generalized "powerpoint" style Charles refers to. I do not like being force fed data so many different ways. Give me the data, add a nice demo, and that is it. I don't need data, then demo, then sidebar, then another example, end of chapter test, all interspersed with jokes.

  8. Avatar for Robb Allen
    Robb Allen April 28th, 2007

    Bah. I own both books and use them as counterparts to each other. While Petzold's is more in depth than Nathan's, I can find what I'm looking for quicker in Nathans.
    Oh, and one point that's being overlooked here. This is Windows PRESENTATION Foundation. It's all about how stuff looks.
    Charles' book falls flat in this regard. You have to 'imagine' how the code is going to look after you write it. And oddly enough, it never shows up as gray backgrounded black text ;)
    WPF Rocks, btw. Totally rocks.

  9. Avatar for Ignorant Bystander
    Ignorant Bystander April 29th, 2007

    "studies after studies show that appropriate use of images and graphics improve recall"
    Any links to any of these?

  10. Avatar for Haacked
    Haacked April 30th, 2007

    Here is one. I'll post more later when I get home.

  11. Avatar for ASPInsiders
    ASPInsiders October 3rd, 2007

    Jeff Atwood recently published a blog entry titled How Now to Write a Technical Book , in which he compared