Re: Try selling the sizzle of what you do.

[Paul DuBois <paul -at- kitebird -dot- com>]

On Fri, Feb 14, 2003 at 02:04:45PM -0500, John Posada wrote:
> I have an observation. With almost every deliverable I produce at every
> company I'm at, there is a nagging little voice in my head that says "Why
> are you making this deliverable...everyone but you in the company already
> knows about it." and every time, I'm surprised.
> 
> Sometimes, it is simply getting it on paper and when shown to a group, find
> out that not everyone in the group knew the same thing in the same way.
> 
> Sometimes, what starts out well understood in someone's mind, once he sees
> it on paper, realizes that what he thought he knew...he doesn't.
> 
> I'm constantly pleasantly surprised how seeing something on paper changes
> the way people understand what they thought they did already.

Bingo.

The purpose of writing documentation is to figure out how something
works.

And if you're lucky, it'll help someone else figure out how it works,
too. :-)

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
Buy or upgrade to RoboHelp X3 today and receive the WebHelp
Merge Module for FREE ($299 value). RoboHelp X3's all-new
features include conditional text, completely re-engineered
printed documentation output, Context-sensitive Help Toolkit,
single-source layouts, and more!
Order online today at http://www.ehelp.com/techwr-l


---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit
http://www.raycomm.com/techwhirl/ for more resources and info.