RE: conceptual material in procedures

Subject: RE: conceptual material in procedures
From: "Elizabeth O'Shea" <elizabeth -dot- oshea -at- virtualaccess -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 21 Apr 2005 15:20:45 +0100

Hi Eileen -

>Because the material is for employees, and I'm talking about their
jobs, I want to include this kind of conceptual
>information. However, I know that for procedures, you usually tell how,
and don't burden the reader with why.

I second Lisa's suggestion: chunk the conceptual information into a
section separate from the procedure.

Do remember to consider what media you're presenting the info in and how
the users will use it when you do the chunking. This will affect how you
chunk. For example, you may want to put all the conceptual info into one
section, as Lisa did, or you may want to have task-based chapters that
contain one subsection on the concept and another subsection on the
procedure. You may also want to present tables with codes as job aids
(cards, printable one-page pdfs, or something similar) in addition to
presenting them in the text.

elizabeth -dot- oshea -at- virtualaccess -dot- com


Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:

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

conceptual material in procedures: From: Neumann, Eileen

Previous by Author: RE: Do you log on or logon to a website?
Next by Author: [rant] Word styles and templates
Previous by Thread: Re: conceptual material in procedures
Next by Thread: RE: conceptual material in procedures

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

Sponsored Ads