Re: wording for training materials

Subject: Re: wording for training materials
From: "Bonnie Granat" <bgranat -at- editors-writers -dot- info>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 17 Oct 2002 11:37:28 -0400







----- Original Message -----
From: "Writer Whirler" <a_whirler -at- hotmail -dot- com>

>
> Please help me settle a difference of opinion. A writer in my group
wrote a
> PowerPoint presentation about the new features of a new release of our
web
> site. The audience for the presentation was support people. In our
user
> guides, we always refer to the user as "you". Throughout this
presentation,
> this writer used "the user" instead. When the presentation went for
editing,
> the editor wanted all "the user" references to be changed to "you".
The
> writer didn't do it (and sent the presentation out as final), saying
that it
> wasn't necessary because the audience was support people, not users.
The
> opposing opinion in our group says it should have been changed because
the
> editor (who is also the manager) has final say in matters of style,
but also
> because "you" is just as understandable (perhaps even more so....less
words
> to read, less awkward construction...), and because the trainers
presenting
> most likely are saying "you can now do this...." rather than "the user
can
> now do this...."

By "support people", do you mean "technical support people" or
"secretaries and administrative assistants"??
If you mean "technical support people", and if there is a reason to
distinguish between *users* of the system -- the people that technical
support people deliver their services to -- and the support people to
whom the presentation was directed, the distinction in the training
materials seems correct.

The writer should have, however, argued for the use of a different term
for the audience than "you" with her manager and not disobeyed a
directive.

In some instances, it would seem that it would be silly to say "you" to
a group of people who are getting ready to deliver services to people
who are *using* the system. It seems the distinction would be crucial
for effectively communicating to the audience their responsibilities.

Bonnie Granat
http://www.editors-writers.info




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at http://www.ehelp.com/techwr-l

Buy ComponentOne Doc-To-Help 6.0, the most powerful SINGLE SOURCE HELP
AUTHORING TOOL for MS Word. SAVE $100 on the full version and $50 on the
upgrade. Offer ends 10/31/2002 (code: DTH102250).
http://www.componentone.com/d2hlist1002

---
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:
wording for training materials: From: Writer Whirler

Previous by Author: Re: Need another term for Julian date
Next by Author: Re: Resume citation for ex-companies
Previous by Thread: wording for training materials
Next by Thread: Re: wording for training materials


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


Sponsored Ads