Re: Documents I'd like to see...

[John Posada <jposada01 -at- yahoo -dot- com>]

Give a man a fish...

I'd rather be given a document that tells me howto do the process,
ten let my imagination apply the process, then be told how to do a
"flavor" of process and not know how to apply it to another process. 

OTOH, I've created user documentation that gave a generic process,
then showed an example of it being applied...did this in a help
application too.  Gave the steps, then a link to another pagede that
showed the steps in opperation.

> Why is there such a dearth of ?solution? based
> documentation?  Everything seems to be ?process-oriented?
> rather than ?results-oriented.? Reference manuals and user
> guides are fine, but sometimes I?d like to see an example
> of the functionality in actual use, rather than
> ?Select-File-Click-OK.? Am I alone in this or do others
> feel this way too?


=====
John Posada, Senior Technical Writer
"I am a bomb disposal expert. If you see me running, try to keep up."
mailto:john -at- tdandw -dot- com, 732-259-2874

__________________________________________________
Do You Yahoo!?
Get personalized email addresses from Yahoo! Mail
http://personal.mail.yahoo.com/

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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

TECH*COMM 2001 Conference, July 15-18 in Washington, DC
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com


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