RE: Grammar Q

Subject: RE: Grammar Q
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: "Zen C" <zenizenc -at- gmail -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 17 Jan 2008 17:35:30 -0500

These things are mostly a matter of convention and preference, and might
vary by industry and country.
The use of 'etc.', 'e.g.', 'i.e.' in your docs is a matter between you
and your documentation deity (or you and your manager/overseer/handler,
but if you are supposed to be writing for a fairly low level of reading
comprehension (factory workers, for example) or for an audience with
English as a second or third language, you might want to just spell out
"and so on", "for example", and "that is" or "that is to say". Not
everybody who even knows what etcetera means is able to pronounce it
(how often do we hear eksettera? about as often as we hear nookyuler?
(pet peeve)). Exempla gratia and ibid est would probably be lost on many
people, so why give them a hard time?
Which person to use?
You are talking to persons, not about persons. Use second person.
Use declarative sentences and commands. "Do this..." "Do that..." with
"you" understood.

Unless, of course, you need to refer to what somebody else might do that
affects what your audience must now do... For _that_ you can use third
person.

But this is all just opinion and preference.
What does your style guide say?
No style guide?
Write one. Then use it to bludgeon anyone who disagrees with you.

Kevin


On Behalf Of Zen C wrote:
> Sent: Thursday, January 17, 2008 10:40
> To: techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: Grammar Q
>
> Use of second, and third person in technical writing?
>
> The intended audience varies from specialized to general, and the same
> tasks
> can be done by both in some situations.
>
> What is the most acceptable way of referring to the audience in the
user
> manual that provides conceptual and step-by-step instructions.
>
> Will you refer to the audience with 'you', 'user' or be more specific
to
> refer to both audiences separately based on the task.
>
> The company needs only one and only one document to cover all levels
of
> audience.
>
> What are the rules on using 'etc' in technical writing?
>
> Zen

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.


Follow-Ups:

References:
Grammar Q: From: Zen C

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


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

Sponsored Ads


Sponsored Ads