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.
Re: The audience doesn't know what it needs was: RE: What is "well Written"?
Subject:Re: The audience doesn't know what it needs was: RE: What is "well Written"? From:John Posada <jposada01 -at- yahoo -dot- com> To:"Stansbury, Stan" <SBS -at- dolby -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com Date:Wed, 16 May 2007 09:00:59 -0700 (PDT)
> Uh, excuse me, is this true of you, as members of the audience
> for tech writing tool documentation? Do you not know what it is
> that you need from it?
> Why would you assume that users of any other application are any
> different in that respect?
We have a customer...a VERY large organization...in its space,
probably one of the top three in the world.
They've made requests to us over and over "We want more
documentation."
Know what? They don't want MORE documentation...they want better
documentation. They want documentation that gives them what they
need. They think that if you tell them EVERYTHING, then it has to
include what they are looking for, when in reality, double the amount
of documentation and even if we ended up giving them what they
needed, they wouldn't be able to find it.
Wouldn't it be better to qualitatively find out what they are looking
for and give that to them?
John Posada
Senior Technical Writer
"They say everyone needs goals. Mine is to live forever.
So far, so good."
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-