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.
The audience doesn't know what it needs was: RE: What is "well Written"?
Subject:The audience doesn't know what it needs was: RE: What is "well Written"? From:"Stansbury, Stan" <SBS -at- dolby -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 16 May 2007 08:48:53 -0700
> -----Original Message-----
> From: techwr-l-bounces+sbs=dolby -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-
> bounces+sbs=dolby -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of John Posada
> Sent: Wednesday, May 16, 2007 7:47 AM
> To: Chinell, David F (GE Indust, Security);
techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: RE: What is "well Written"?
>
> --- "Chinell, David F (GE Indust, Security)" <David -dot- Chinell -at- GE -dot- com>
> wrote:
>
> > cost. But I got bogged down (as did many here) on determining what
> > "quality" documentation is. In the end, there was simply no simple,
> > meaningful way to determine this quality.
>
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?
I personally am so frustrated by the quality and usability of the
documentation for my writing tools that I use it as an example of what
to avoid in my own work.
> to discount the oft-repeated chant "Know they
> audience" because most times, the audience doesn't know what it needs
> and you can only figure this out through continued testing and
> improvement modifications.
-----------------------------------------
This message (including any attachments) may contain confidential
information intended for a specific individual and purpose. If you
are not the intended recipient, delete this message. If you are
not the intended recipient, disclosing, copying, distributing, or
taking any action based on this message is strictly prohibited.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-