Re: Try selling the sizzle of what you do.

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

On Fri, Feb 14, 2003 at 02:53:59PM -0600, Korth, Deanna wrote:
> Ain't that the truth! I documented a module a few months ago, and it took
> forever to figure out how it really worked because each SME understood it in
> a different way. I uncovered some flaws in the design just by asking the
> right questions. It was the most rewarding document I've written to date.
> 
> Deanna

I often find that documenting software is an exercise in debugging.
In order to really understand how a program or part of a program works,
it pays to exercise it in lots of different ways, often in ways that
the developers never thought of.  My experience is that this frequently
uncovers bugs in the software.

I concur that this can be rewarding, at least when working with
developers that actually care about fixing bugs rather than defending
their software against criticism. :-)

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
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.