Grammar Q

[Chesler, Lynn]

I just have to put in my 2 cents. I like "you"; however, I didn't always
feel this way. I used to go out of my way to avoid it because I thought it
sounded odd. 

Now I just love it. I think it adds a level of familiarity and
conversation to what might otherwise be a very dry document. I am
currently editing a documentation set that was written by the engineers,
many of whom went out of the way to avoid the word "you" by overusing the
passive voice.

Like so much of writing, it's a matter of preference. I think that as long
as we're clear and write to our audience, we have some latitude. As a lone
writer, I get to write the style guide, which makes it more fun for me.
Hee, hee, hee. 

Lynn

-----Original Message-----
From: techwr-l-bounces+lchesler=auspicecorp.com at lists.techwr-l.com
[mailto:techwr-l-bounces+lchesler=auspicecorp.com at lists.techwr-l.com] On
Behalf Of Roy Jacobsen
Sent: Friday, January 18, 2008 5:14 PM
To: techwr-l at lists.techwr-l.com
Subject: Re: Grammar Q

Ben wrote:
> A possible guideline is use the word, you, in   non-procedural content,
but avoid it otherwise. 
>   
I have to ask: Why? Why avoid the word "you?" What is the benefit to the
reader?

I believe that conversational writing is better accepted by readers,
regardless of the content or context.

Note: By "conversational," I do not mean chatty, sloppy, or colloquial. 
I mean writing using the same basic language that you would use to talk to
a friend, family member, or acquaintance.

Yes, by all means use the Imperative mood in procedural (or even
non-procedural) content. If I were instructing a friend in face-to-face
conversation, I would say "Click the Franistan button." But I would also
say to that friend "Check that you've entered all the Fritzin information
before you click the Franistan button." Avoiding the second-person pronoun
would force me to shift things to a passive-voice "Check that the Fritzin
information has been entered..." Bleagh!

Again, why avoid "you" in any content, procedural or otherwise?
-- 

*Roy Jacobsen*

Writing, Clear and Simple
1043 10^th Street North
Fargo, ND 58102
USA

	

701.866.9920
royj at writingclearandsimple.com <mailto:royj at writingclearandsimple.com>
<mailto:royj at writingclearandsimple.com>rmjacobsen.squarespace.com
<http://rmjacobsen.squarespace.com/>



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

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 lchesler at auspicecorp.com.

To unsubscribe send a blank email to 
techwr-l-unsubscribe at lists.techwr-l.com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/lchesler%40auspicecorp.
com


To subscribe, send a blank email to techwr-l-join at lists.techwr-l.com

Send administrative questions to admin at techwr-l.com. Visit
http://www.techwr-l.com/ for more resources and info.