Re: One Doc or Multiple Docs?

Subject: Re: One Doc or Multiple Docs?
From: Michele Davis <michele -at- krautgrrl -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 02 Nov 2000 09:50:00 -0600

Please post answers to the list, or cc me. I'm dealing with a similiar issue. I
had a prospective client ask me yesterday:

"How would you address five different audiences in one manual, and one online
help system?"

The software product is for graphic designers, and web developers, some people
will be running Linux, and some Win2000, and they want to combine all the
information in 1 manual. Oy guvalt!

My manual would have the same 5 chapters as Dawson, except there would be an
additional chapter on UI navigation for the neo-phobes. In addition, I'd be
addressing two operating systems.


Dawson McKnight wrote:

> All,
> How "consolidated" is your documentation set? Do you provide installation,
> administration, configuration, and troubleshooting guidance in a single
> document (e.g., an "Administrator's Guide"), or do you provide each of these
> kinds of instructions in a different document? Without a substantial user
> base, how can I determine how consolidated my documentation set should be?
> Here is how our documentation looks now:
> * Installation guide
> * Overview: Describes the product's architecture, functions, and features
> * Administration guide: Setting up security policies using an
> administration GUI (e.g., creating users, determining what they should have
> access to, etc.)
> * Configuration guide: Configuring the various components (servers) to
> communicate with each other in a distributed environment
> * Troubleshooting guide

Learn how to develop HTML-based Help with Macromedia Dreamweaver!
Dec. 7-8, 2000, Orlando, FL -- $100 discount for STC members. or 800-646-9989.

Sponsored by SOLUTIONS, Conferences and Seminars for Communicators
Publications Management Clinic, TECH*COMM 2001 Conference, and more or 800-448-4230

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: E....
Next by Author: Re: Voice Recognition Software
Previous by Thread: One Doc or Multiple Docs?
Next by Thread: Re: One Doc or Multiple Docs?

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

Sponsored Ads

Sponsored Ads