Friday, May 05, 2006

microsoft, my hero

| 0 comments |

I think that on some levels, MS Outlook is MS's best product, judged by the features and high level of usability. Unfortunately for them, google has raised the bar really high. I'm talking about one feature in specific - the search function. I don't know how many of you use Google Desktop search (yes, I'm aware of all the security issues), but it is fabulous. Google gives you a really fast and accurate search tool for Outlook messages.

gmail is the same - the search function is fast and accurate. By comparison, when you use the built in search tool for outlook, it takes forever to search, and the results are questionable. MS should spend their billions and make the search function (in outlook, and systemwide) a real centerpiece of their user-centric applications. For yes, we are at that point when there's too much data to keep track of in our brains.

Thursday, May 04, 2006

technical writer value and attention

| 0 comments |

Ooooh, look, I have an idea about Technical Writing in graph form. This looks like those economics graphics that explain a behavior, not the science graphs that have an independent and dependent variable. (click the graph to see it un-resized)



Here are my ideas -

1. The Red Line approximates the ideal situation for learning. Effective learning thought documentation CAN happen when the topic's complexity is proportional to the user's knowledge about the topic.

2. The further you are from the red line, the harder it is for documentation to add any value to the knowledge transfer. (Above the line, and the user ignores the docs, below the line and the docs can’t respond to the user’s needs)

As far as the technical writer is concerned:

3. The less complex a topic, the more user hand-holding is required. Your writing has to really be attentive to the user's needs to get him/her up to speed.

At some point in the middle of the red line, the user transitions from a beginner to an intermediate or advanced user. This transition signifies when you as the writer can place more emphasis on the topic, and less emphasis on metaphor and explanations.

4. The Blue Box represents the technical writing sweet spot. I define the sweet spot as the point on the graph where

  • The tech writer can provide the most value to the knowledge transfer.
  • The tech writer experiences the greatest challenge (and hopefully reward) for his or her work.

When you are outside of this box, you are either creating ultra-boring documentation or high-level documentation that’s probably best left for an expert to write and an editor to tighten.

Thoughts, comments?