TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
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.
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.