Re: User Guide - best practices

Subject: Re: User Guide - best practices
From: Sandy Harris <pashley -at- storm -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sun, 28 Jul 2002 11:21:31 -0400


Lisa Conway wrote:
>
> Hi all,
>
> I'm a tech writer for a software company. My question concerns our user
> guide. It is almost 500 pages and includes both descriptions of every window
> and the various tasks a user would perform when using our application. We
> also have another shorter manual for the same application that only includes
> the tasks. My question is should we just go with the task based manual or is
> it necessary to have a user guide that includes detailed descriptions of
> every window? Our users are not always very computer savvy. ...
> What is the current best practice for a software manual?

I'd be inclined to split it up into a reference section and a
task-oriented
tutorial section.

The reference section gets all the detail available, anything a user
might
want. Not just window descriptions, but things like info on the file
formats
you use for storing the data, since someone building an application that
interacts with yours might need that. It can be organised
alphabetically,
perhaps in sections. User commands, administrator-only commands, window
titles, ...

The tutorial section describes user tasks, and cross-references to the
reference section as necessary.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Buy RoboHelp Deluxe starting at only $798: you'll get RoboDemo, the hot new
software demonstration tool that's taking the Help authoring world by storm,
together with RoboHelp Office. Learn more at http://www.ehelp.com/techwr-l

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

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


References:
User Guide - best practices: From: Lisa Conway

Previous by Author: Re: Certificate Authority Services
Next by Author: Re: Average Hours Worked
Previous by Thread: User Guide - best practices
Next by Thread: RE: User Guide - best practices


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


Sponsored Ads