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

  • 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...
  • 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, ...
  • The Power of Words
    There's nothing like an election to illustrate how powerful words are. Politicians, pundits, and the media use words to advance their ca...
  • 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...
  • Why info systems fail
    If you only have time to read one news article today, read this one from the Financial Post. Don't leave IT to the techies - Three probl...
  • How to update a document - NOT!
    Canadian International Co-operation Minister Bev Oda needs to work on her document management skills. She hand wrote the word 'NOT'...
  • Publishing for Pollard
    Most of you probably have never heard of Jonathan Pollard, the American who has been languishing in prison since November 21, 1985, almost 2...
  • The Dynamic Blogger
    Some of you may have noticed the new look of this blog. It's a new Blogger feature called dynamic views . You can now choose how this bl...
  • Dude, where's my document?
    Try this experiment: Think of a printed guide you worked on. Find the source document from your current location. Make a minor change to the...
  • Security breach!
    It's always entertaining to read about non-lethal lapses in security at a major event. Remember the debacle at the 2010 Winter Olympics?...

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