Re: Question - Training Guides - Who Writes?

Subject: Re: Question - Training Guides - Who Writes?
From: Lauren <lauren -at- writeco -dot- net>
To: Margaret Alston <diamondvapor5 -at- yahoo -dot- com>
Date: Tue, 15 Sep 2009 00:32:21 -0700

I've interviewed SMEs to write training manuals and to prepare training
documentation, like handouts and PowerPoint presentations. I had no
familiarity with the processes that I documented and I did not perform
the training. My first step in developing such documentation is to
learn about the audience and my usual first question concerns the
education level of the users. I also learn the audience's experience
level with the product and their understanding of product terms that I
define in a glossary.

I write for a generic audience of appropriate education level and
product experience for whatever I am documenting. People with less
education require simpler documentation and people with less experience
require more explanation, while documentation for more educated and
experienced people becomes more compact.

"Prettying up" documentation never really produces high-quality content,
since non-writers frequently produce documentation that is too specific
or vague for a varied audience.


Margaret Alston wrote:
> Hi all:
> At my last 3 jobs, the trainers themselves wrote the training guides and the Documentation dept reviewed and prettied them up. At this job, I am told that I am responsible for writing up all the procedures as well. I don't go out and train, I can only just look at the software and write the routines, which is fine but I don't know business processes and am not close to the clients, obviously. I would think being close to the clients makes for more 'real" training.
> Can anyone comment on this? What do you think is ideal? What are your company experiences?
> Thanks
> J


Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:

Question - Training Guides - Who Writes?: From: Margaret Alston

Previous by Author: Re: Use of Optional in instructions
Next by Author: Re: one vs 1
Previous by Thread: RE: Question - Training Guides - Who Writes?
Next by Thread: RE: Outlook hosed, pondering next step

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

Sponsored Ads