"RE: Grammar Q

Subject: "RE: Grammar Q
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 21 Jan 2008 15:13:18 -0500

Lauren sez:

[...]
> There is not a reason to refer to any "person" in a procedural
document.
> I
> do refer to roles, but references to persons, like "you," a gender, or
> "their" for an individual, are unnecessary.
-- start bogus example --
6. Upon receiving the User's certificate, add it to the standard
template that you created earlier, to form a Profile for that User.
7. Store the profile in the Profile database.

Note: When working with a small number of Users, you can perform this
task manually. For larger numbers of users (or for unattended operation
of the sign-up process) see the section on _Scripting and Automation_.

-- end bogus example -

Were you offended by the tone of the instructions, or by the use of
"you" in the Note?

I realize that some nationalities or cultures would actually be at least
mildly offended, because their language and culture is built on
non-intrusion and self-effacement. So far, I have no incentive to bend
over backwards to serve such preferences. If it's really necessary, then
that's what translation/localization services are for.

By the way, is this really a "Grammar Q" at this point, or more of a
"Style Q" ??
Kevin
(who has been wrong before...)
The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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


References:
Re: Grammar Q: From: Janice Gelb
RE: Grammar Q: From: Lauren

Previous by Author: RE: Grammar Q
Next by Author: RE: Grammar Q
Previous by Thread: RE: Grammar Q
Next by Thread: RE: Grammar Q


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


Sponsored Ads