RE: Rhetoric And Technical Writing?

[<Cindy -dot- Crittenden -at- cox -dot- com>]

I am primarily a user interface designer with a background in technical
writing.  This one issue pretty much drives my entire professional
career.

Poor design drives the need for great documentation, both online and
printed.  Users will admit to rarely reading the manual, but just wait
until they're really stuck and forced to turn to it.  It could be the
greatest documentation ever written, but if it doesn't answer their
question, it's very unlikely they will ever refer to it again.

Now, of course poor design is more often the rule rather than the
exception.  How many times have we all heard "oh, that's a training
issue", or "we'll just cover that in the documentation" coming from
TPTB?

I'll admit, sheepishly, that I myself am not a manual "reader".  I fall
squarely in the category of those that refer to the manual only as a
last resort - so I'm just perpetuating the problem.  :)




-----Original Message----
From: techwr-l-bounces+cindy -dot- crittenden=cox -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cindy -dot- crittenden=cox -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Steven Brown
Sent: Wednesday, March 22, 2006 12:22 PM
To: David Loveless; Bonnie Granat
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Rhetoric And Technical Writing?

Dave, you said something very interesting:

"I RARELY go to the manual for answers because
experience has shown that I end up wasting time trying
to find something that is not there or that is
hidden."

I've often heard this from friends and business
associates. Heck, I've even watched technical writers
not use online help when they should have! 

So the Big Question to all technical writers is, why
don't people read what we write? Are we at all
responsible?

Steven Brown



__________________________________________________
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content

delivery. Try it today!. http://www.webworks.com/techwr-l 

Doc-To-Help includes a one-click RoboHelp project converter. It's that
easy.  Watch the demo at
http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as cindy -dot- crittenden -at- cox -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/cindy.crittenden%40co
x.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.

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

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy.  Watch the demo at http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot- 

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.