Re: giving a toss about documentation

Subject: Re: giving a toss about documentation
From: eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 1 Apr 2005 13:35:39 -0400


bounce-techwr-l-106467 -at- lists -dot- techwr-l -dot- com wrote on 04/01/2005 12:27:34 PM:
> Right. Another bad analogy would be buying a car, microwave,
> refrigerator, toaster...

Why?

The goal of good enduser oriented commodities and products (software or
hardware) should be ease of use and the elimination of documentation.

That being the case, is it not better that a business avoid investing in
documentation when they could invest the same money in development to
eliminate the need for the documentation by producing a more user-friendly
product?

I was to buy software, use it, and find the help or documents lacking, I
would much rather be served well by customer service and then see the
product changed. Not the problem glossed over in documentation.

Unless my way of seeing the world is vastly different from the norm, I
view any need to go to documentation for how to execute familiar or
standard tasks as an ultimate critique of the product design. Fix the
product not the documents. If the product is fixed no-one will call for
support, even those that don't read documentation. Fix the documentation
and you'll still get calls, customers will still be frustrated with your
product, and you won't have changed too many people's opinion about the
quality of the product design.

Eric L. Dunn
Senior Technical Writer

_______________________________________________________________________________________________________________

This e-mail communication (and any attachment/s) may contain confidential
or privileged information and is intended only for the individual(s) or
entity named above and to others who have been specifically authorized to
receive it. If you are not the intended recipient, please do not read,
copy, use or disclose the contents of this communication to others. Please
notify the sender that you have received this e-mail in error by reply
e-mail, and delete the e-mail subsequently.
Thank you.
_________________________________________________________________________________________________________________


Ce message (ainsi que le(s) fichier/s), transmis par courriel, peut
contenir des renseignements confidentiels ou protégés et est destiné à
l?usage exclusif du destinataire ci-dessus. Toute autre personne est par
les présentes avisée qu?il est strictement interdit de le diffuser, le
distribuer ou le reproduire. Si vous l?avez reçu par inadvertance,
veuillez nous en aviser et détruire ce message.
Merci.
_________________________________________________________________________________________________________________




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

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -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.



Follow-Ups:

References:
Re: giving a toss about documentation: From: Bill Swallow

Previous by Author: Re: giving a toss about documentation
Next by Author: Re: giving a toss about documentation
Previous by Thread: Re: giving a toss about documentation
Next by Thread: Re: giving a toss about documentation


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


Sponsored Ads