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

  • 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 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...
  • 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...
  • 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 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...
  • 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...
  • Lessons from the 2011 Canadian Election
    The results of Canada's recent federal election were truly stunning. If you're not Canadian (or are but have been living under a roc...
  • An OS is not O/S
    Being a person of many hats, it only made sense to buy one recently - one with a large brim to protect myself from UVA, UVB, and whatever ot...
  • The Matter of Dark Text
    Physicists have many odd ideas, but one of their oddest surely is dark matter . It is the dense, invisible stuff which fills the universe, ...

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