Re: Try selling the sizzle of what you do.

Subject: Re: Try selling the sizzle of what you do.
From: Paul DuBois <paul -at- kitebird -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 14 Feb 2003 17:29:46 -0600


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.



References:
RE: Try selling the sizzle of what you do.: From: John Posada

Previous by Author: Re: "Platform" vs. "OS"?
Next by Author: Re: Try selling the sizzle of what you do.
Previous by Thread: RE: Try selling the sizzle of what you do.
Next by Thread: RE: Try selling the sizzle of what you do.


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads