Tech Word

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

Tuesday, 7 April 2009

The Matter of Dark Text

Posted on 14:39 by Unknown
Physicists have many odd ideas, but one of their oddest surely is dark matter. It is the dense, invisible stuff which fills the universe, but its existence can't be proven directly, hence the term dark. It also has a sister: dark energy. Dark energy, like dark matter, is also invisible and cannot be directly proven to exist. However, dark energy appears to explain why the universe is not only expanding, but doing so at an accelerated rate.

Scientists are working hard to find out which of these two things is more abundant in the universe. If there is more dark matter than dark energy, then the gravity of the dark matter could eventually cause the universe to stop expanding and then start shrinking, collapsing into a single point, in a very noisy event called a "big crunch". Alternatively, if there's more dark energy than dark matter, it could mean that the universe will continue to expand but, like spots on an expanding balloon, everything will be pulled further and further away from each other, resulting in a very cold, lonely universe.

The good news is that either scenario won't happen for billions of years. The bad news is that in either case, all living things will cease to exist. To paraphrase Einstein, "Bummer."

Fortunately, the other two qualities of our universe, space and time, don't have a corresponding "dark" component; that is, there's no such thing as dark space or dark time, except perhaps on Star Trek. However, there is a corresponding component in our profession, and it is called dark text.

Dark Text Matters

Dark text refers to the many layers of hidden meaning in any text segment. It ranges from the implied meaning that the author intended, or that the reader infers, to much deeper, more hidden meanings.

Here's a simple example:

To print a document, click Print.

The dark text of this step is:
  • a document is a piece of paper
  • you'll need a printer to print something
  • "clicking" involves position the cursor on a monitor over a certain graphical element
  • the printer must be connected to a computer and must be configured correctly
Darker text could include:
  • you should be careful before you print something: once it's printed, you can't "undo" it
  • the printer must have toner and paper; electricity would also be helpful
  • if you can't figure this out, call your 11-year old relative who knows more than you do about computers
There's Nothing Funny About Funny Money

Here is a more interesting example. In stores, you often see this sign:

We do not accept $50 or $100 bills.

The first level of dark text is derived from the fact that this statement does not explicitly tell the reader what to do or not do. So the "obvious" (or lighter) dark text is:

Don't even try to give us $50 or $100 bills.
The next level of dark text is:

We don't want counterfeit money, which typically is $50 or $100 bills.

However, there is a third level of dark text, which is darker (and more sinister) than these two other levels.

Because we don't accept $50 or $100 bills, we will accept $5, $10 and $20 bills, even if they are counterfeit.

This, in fact, is exactly what has been reported by the authorities. Counterfeiters know that unless stores are checking every bill they get, they will simply assume the lower denomination bills are legitimate. These stores have inadvertently given a sign to these criminals that they will take their fake money.

What, then, should the sign say, to scare away any potential counterfeiters? Perhaps something like this:

WARNING! We check all paper currency to make sure it is not counterfeit. If you try to use counterfeit money here, you will be caught and prosecuted to the fullest extent of the law. Punishment can include a major fine and imprisonment for up to 14 years.

Note that most of the dark text has been removed. This is what is known as "writing from the user's perspective".

* * *

As technical writers, we must be aware of dark text, and where possible, try to minimize it. It's true that we cannot possibly document all of the hidden meaning in text, nor should we. Still, much information may be hidden or very subtle and must be exposed or more clearly stated. To decide when to expose dark text, you need to ask yourself:

Would a typical user need to know this fact in order to more effectively use the thing I am documenting?

The goal is to give users all the information they need to do their jobs, and no more than that. This is an axiom of technical communication, and will be so until the end of the universe.
Read More
Posted in bad communication, science, simplicity | No comments

Friday, 3 April 2009

Ikea Explained

Posted on 11:46 by Unknown
The Swedish furniture store Ikea revolutionized both home furnishing and documentation. By having the consumers perform the assembly themselves, Ikea is able to both lower costs and slowly drive their customers insane.

To be fair, Ikea assembly instructions are not that bad. They brilliantly only use pictures, which are clearer than text and require no translation. Still, recognizing that some people may still have difficulty understanding them, I offer this handy explanation of some typical Ikea instructions that came with a bookshelf I recently bought. I'll show the actual graphic, followed by a clear and concise textual explanation.



1. To assemble this furniture, you need to speak "Tool", specifically the "Two-Screwdrivers-And-A-Hammer" dialect. You should also have no hands but rather two oblong stumps as fingers on your left hand, and a curly quote as a right hand. Finally, avoid extending your smile too much as it may cause the upper portion of your head to fall off.

***


2. Avoid merging your two stumpy fingers into the box if the large black "X" is still attached to it.

***

3. The best way to transport a two-dimensional rectangle is with a defective clone of yourself, one with a crinkled head. Also, both of you should be naked.

***

4. Didn't we already tell you to remove the big black X? You must now kneel in humiliation before the shattered monolith, which has already begun to spawn small fortune cookies.

***


5. To repair the monolith, simply merge with it, transferring your healing energy, while the monolith rests on a magic carpet. Smile (but not too much, because of that head-splitting problem mentioned in step 1.)

***

6. Ponder how the monolith has shrunk in size after resting it against a nearby hyper-cube. Play the accordion using only one eye.

***


7. If you're still having trouble following these instructions, attach your very large left ear to a piece of string, and connect it right under our store. Be sure to wrap the string around your legs so that when the store hovers away into the heavens, we may take you with us to the New World.

***

I just don't know why anyone would think these instructions are hard to follow...
Read More
Posted in business | No comments

Extra Sweet Instructions

Posted on 11:25 by Unknown
I'm in a fruit phase this month. I recently wrote about watermelons; this article will discuss pineapples, for I am equal opportunity fruitist.

Here's the instruction manual that came with a pineapple I bought:



(You definitely know you're different from normal people if you find yourself scanning fruit instructions.)

This is documentation at its most elegant. No words. Just pictures. Slice, dice and enjoy!
Read More
Posted in business, food, simplicity | No comments
Newer Posts Older Posts Home
Subscribe to: 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)
      • The Matter of Dark Text
      • Ikea Explained
      • Extra Sweet Instructions
    • ►  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)
    • ►  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