Re: Grammar Q

Subject: Re: Grammar Q
From: Janice Gelb <Janice -dot- Gelb -at- Sun -dot- COM>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 18 Jan 2008 12:17:47 +1100

Lauren wrote:
> 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?!

Um, because that's its purpose: to tell you how to accomplish

> So I say, avoid "you." Not *you* per se, but the term "you."

I find "you" much the best choice of the alternatives available.
I've seen people try to "solve" this problem by establishing a
name like Fred, and then referring to "Fred" and "he" and I
find that really klutzy. And as I strongly believe in gender-
neutral language, "you" and "their" win out.

-- Janice

Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address

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: Lauren

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