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: Sat, 15 Feb 2003 09:27:32 -0600


At 11:10 +0000 2/15/03, Peter Hirons wrote:

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

Which leads to the inevitable question "Do you want me to document it the
way the spec says it ought to work, or the way it actually works?"

That is never a question. Documentation documents actual behavior,
or else it is fiction.

One might say "X is intended to do Y, but it actually behaves like this..."
of course.


Peter
Nr Clonakilty, Co Cork, Ireland


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.



Follow-Ups:

References:
Re: Try selling the sizzle of what you do.: From: Peter Hirons

Previous by Author: Re: Try selling the sizzle of what you do.
Next by Author: Re: Documenting the way software actually works WAS: 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