RE: Grammar Q

Subject: RE: Grammar Q
From: "Lauren" <lauren -at- writeco -dot- net>
To: "'McLauchlan, Kevin'" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>, "'Zen C'" <zenizenc -at- gmail -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 17 Jan 2008 15:20:51 -0800

> From: McLauchlan, Kevin

> No style guide?
> Write one. Then use it to bludgeon anyone who disagrees with you.

Sounds like somebody is having a Monday (it's Thursday), but I agree with
all of the stuff about infinite lists and which person to use.

About infinite lists: one instructor I had taught that an infinite list,
such as list that ended with "etc.," should be replaced with a finite list
that began with "for example" or "such as" and didn't end with an infinite

I also have strong aversions to second-person usage in documentation. I
read one help document that began nearly every sentence with "you" and
contained such statements as "you must..." and "...then you click..." I got
annoyed. Why was this document telling me what to do?! So I say, avoid
"you." Not *you* per se, but the term "you."



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.

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

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.


RE: Grammar Q: From: McLauchlan, Kevin

Previous by Author: RE: within vs. in
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