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
incomplete?

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>
http://campbell-online.com
http://enrevanche.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! http://www.webworks.com/techwr-l

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. http://www.componentone.com/TECHWRL/DocToHelp2005

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

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
http://www.techwr-l.com/techwhirl/ for more resources and info.


References:
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