RE: Documenting complex tasks in Online Help

Subject: RE: Documenting complex tasks in Online Help
From: "Andrew Dugas" <dugas -at- intalio -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 9 Sep 2002 12:31:15 -0700



IMO, it really depends on a number of things.

For example, you say the person must go through screens 1 - 5 before
arriving at the REAL TASK of screen 6.

My first consideration would be: what am I documenting here? The screen 6
task or a workflow of tasks represented by screens 1 - 6?

My second consideration would be: Is this a linear process? Do the screens
always follow in this sequence? For example, is screen 3 a task someone
might perform independently of screens 1, 2, 4, 5, and 6? Is screen 6 always
dependent on screens/tasks 1 - 5 being performed immediately before?

If the six screens/tasks comprise a regular workflow, in which the sequence
is repeated each time the workflow is carried out, I would see myself as
documenting that workflow and break it down by screens/tasks. Each
screen/task would have a caveat that the preceding tasks need to be
completed first. But I would precede the whole thing with a brief overview
of all the parts explaining what they were doing.

If the different tasks could be performed independently, I would present
them the same way but with the overview slanted accordingly, if included at
all.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out the new release of RoboDemo, our easy-to-use tutorial software.
Plus, buy RoboHelp Office in August and save $100 with our mail-in rebate.
Get details and download free trial versions at http://www.ehelp.com/techwr-l

Absolutely FREE! FrameMaker/Win 6 & 7 Express Customization (v3):
Quick-access buttons & keys to common functions, char tag/font drop-down
lists, charset browser, QRef guides & much more: http://www.microtype.com/2

---
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:
Documenting complex tasks in Online Help: From: Andrew T. Brooke

Previous by Author: RE: what should I say?
Next by Author: RE: what's the world coming to
Previous by Thread: Documenting complex tasks in Online Help
Next by Thread: Re: Documenting complex tasks in Online Help


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


Sponsored Ads