Tech Word

  • Subscribe to our RSS feed.
  • Twitter
  • StumbleUpon
  • Reddit
  • Facebook
  • Digg

Wednesday, 24 October 2007

Snakes on a User Guide

Posted on 13:03 by Unknown
"Snakes on a Plane? What's that about?"
From the Dilbert Newsletter

I just finished watching the awesome action film, Snakes on a Plane. Only a technical writer could have come up with such a self-descriptive title. It ranks right up with The 40 Year Old Virgin, Silent Movie and Robin Hood: Men in Tights. Can you imagine what other films would have been called had this explicitly self-descriptive technique been applied? Here's a partial list:
  • Titanic - A Very Big Ship Hits A Very Big Iceberg; Hundreds Die
  • The Godfather - A Whole Lotta Italians and Others Get Whacked
  • Harry Potter - Good Wizards Fight Really, Really, Evil Guys
  • Star Wars - Many Spaceships Chase Each Other and Blow Up Real Good
  • Lord of the Rings - A Bunch of Extremely Annoying Creatures Go Chasing After a Stupid Ring
  • Shrek - Funny, Big, Green, Scottish Ogre Rescues a Princess
  • Jaws - Not So Funny Big Shark Eats Various People
Somehow, I don't think these films would have done as well. In any case, Snakes on a Plane is an excellent example of how user feedback can be effectively incorporated into the main product. The film generated so much Internet buzz that the producers reshot the film, making it more violent and explicit, causing the film's rating to be changed from PG to R. Rather than suing all the fans who created websites and blogged about the film, the film industry actually embraced the fans and updated the film based on their feedback.

Not only was this an absolutely unprecedented way of producing a film, it is a model for the way documentation should be created and reviewed. Select clients and power users should be allowed to see early drafts of our documentation, so that they can suggest changes. This is often done for the actual software - why not documentation? Then we'd no longer have to scream, paraphrasing from the movie:

Get these mother-****ing errors out of my mother-****ing draft!
Email ThisBlogThis!Share to XShare to Facebook
Posted in entertainment | No comments
Newer Post Older Post Home

0 comments:

Post a Comment

Subscribe to: Post Comments (Atom)

Popular Posts

  • The Governing Dynamics of Documentation
    Game theory is a specialized field of mathematics that analyzes choices and results in strategic situations, or games , as the players try t...
  • Failsafe
    President Obama recently proposed an intriguing solution to deal with his country's ever-growing debt: a "failsafe" trigger. H...
  • TECHWRTR For Sale
    If you're an experienced tech writer, you may be asked to do more than just tech writing. You may have to write documents which try to s...
  • The Time-Traveling Tax Man
    I’m one of those incredibly annoying people who file their tax returns early, in order to get my refund early. I file electronically using a...
  • Interviewing and Dating: A Single Source Solution
    Last month, people celebrated "Valentine's Day", a day to celebrate romance and love, a day to be extra-nice to your partner, ...
  • Six Things That Should Be Single Sourced
    Single-sourcing, as we all know, is the art and science of using a single repository of information to produce multiple outputs. Typical ex...
  • Labels and other dogs
    Here I am, in my basement, surrounded by mountains of dog food I'm desperately trying to organize. We own one dog, an odd-looking labrad...
  • Microwaveable Message
    I'm annoyed with the writer who developed the message that appears on my microwave when it's finished cooking. The message is: ENJOY...
  • Single Sourcing Greece's Default
    Greece is now dangerously close to defaulting on its national debt. Despite the recent bailouts, many financial experts believe that the sit...
  • Dr. Drake and the Information Equation
    One of the most fascinating films of 1997 was Contact , starring Jodie Foster. Foster portrays Dr. Ellie Arroway, an astronomer who discover...

Categories

  • art
  • autism
  • bad communication
  • business
  • career
  • cloud computing
  • computers
  • creativity
  • entertainment
  • finance
  • food
  • Google
  • history
  • interviewing
  • math
  • media
  • medicine
  • misc.
  • music
  • nature
  • news
  • philosophy
  • politics
  • quantum theory
  • religion
  • resume
  • resumes
  • science
  • security
  • simplicity
  • sport
  • technology
  • usability

Blog Archive

  • ►  2012 (9)
    • ►  September (1)
    • ►  August (1)
    • ►  July (1)
    • ►  April (2)
    • ►  March (2)
    • ►  February (2)
  • ►  2011 (36)
    • ►  December (2)
    • ►  November (2)
    • ►  October (6)
    • ►  September (2)
    • ►  August (4)
    • ►  July (5)
    • ►  June (3)
    • ►  May (6)
    • ►  April (2)
    • ►  February (3)
    • ►  January (1)
  • ►  2010 (47)
    • ►  December (3)
    • ►  November (6)
    • ►  October (4)
    • ►  September (2)
    • ►  August (1)
    • ►  July (2)
    • ►  June (2)
    • ►  May (3)
    • ►  April (5)
    • ►  March (11)
    • ►  February (7)
    • ►  January (1)
  • ►  2009 (36)
    • ►  December (11)
    • ►  November (5)
    • ►  October (4)
    • ►  September (2)
    • ►  August (2)
    • ►  July (3)
    • ►  May (1)
    • ►  April (3)
    • ►  March (2)
    • ►  January (3)
  • ►  2008 (24)
    • ►  December (9)
    • ►  November (1)
    • ►  October (7)
    • ►  July (1)
    • ►  June (1)
    • ►  May (1)
    • ►  April (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (1)
  • ▼  2007 (10)
    • ►  December (1)
    • ►  November (2)
    • ▼  October (4)
      • Publishing for Pollard
      • Snakes on a User Guide
      • The Four I’s of the Perfect Storm
      • Documenting the Referendum
    • ►  August (1)
    • ►  March (1)
    • ►  January (1)
  • ►  2006 (4)
    • ►  September (1)
    • ►  June (1)
    • ►  April (1)
    • ►  February (1)
  • ►  2005 (10)
    • ►  December (1)
    • ►  November (1)
    • ►  October (1)
    • ►  September (1)
    • ►  June (1)
    • ►  May (1)
    • ►  April (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (1)
  • ►  2004 (9)
    • ►  December (1)
    • ►  November (1)
    • ►  September (1)
    • ►  June (1)
    • ►  May (1)
    • ►  April (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (1)
  • ►  2003 (9)
    • ►  December (1)
    • ►  November (1)
    • ►  September (1)
    • ►  June (1)
    • ►  May (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (2)
  • ►  2002 (3)
    • ►  December (1)
    • ►  November (1)
    • ►  October (1)
Powered by Blogger.

About Me

Unknown
View my complete profile