Re: complete documentation

Subject: Re: complete documentation
From: Barry Campbell <barry -dot- campbell -at- gmail -dot- com>
To: Tracy Taylor <ipsque -at- yahoo -dot- com>
Date: Thu, 12 Jan 2006 15:54:06 -0500

On 1/12/06, Tracy Taylor <ipsque -at- yahoo -dot- com> wrote:

> We are lucky in that we get some feedback on our
> documentation from customers, but I'm not always sure
> how to address the feedback.
> For example, we get feedback that we need "complete
> documentation." In your mind, what does that mean?

In my mind, that means I need to ask the customers what *they* mean -
what's missing, in *their* minds? What do they need that they're not
getting? Why are *they* characterizing the documentation as

One of the best things you can do as a writer, if you can swing it, is
to talk to representative members of your audience regularly and find
out how you're doing meeting their needs. Receiving feedback gives
you a golden opportunity to not only get clarification about what
their specific comments mean, but probe more deeply into what they
need and how they're using your docs.

- bc

Barry Campbell <barry -dot- campbell -at- gmail -dot- com>

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today!

Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release.

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

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 for more resources and info.

complete documentation: From: Tracy Taylor

Previous by Author: Re: SnagIt and StarDock
Next by Author: Re: What's wrong with this picture?
Previous by Thread: Re: complete documentation
Next by Thread: Complete documentation?

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

Sponsored Ads