RE: one word, not "if", for "as long as"

Subject: RE: one word, not "if", for "as long as"
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: Lauren <lauren -at- writeco -dot- net>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 23 Apr 2012 13:12:06 -0700

Lauren wrote:

> "You"? I prefer to avoid pronoun references in technical documentation.

Interesting preference. Some of us would say that preference is an example of what you earlier referred to (in the "Help with a term" thread) as "ancient pedantry. ;-)

IMHO, it's good documentation practice to address the reader directly. To Craig's point, avoiding "you" is not only sometimes clumsier but often much less clear. Consider these "you-less" alternatives:

-- The user can use different subdomains, but the top level domain must be the same.
-- Different subdomains can be used, but the top level domain must be the same.

I maintain that both are inferior to Laura's simple, direct formulation.

YMMV, etc.

Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom

Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.


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-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Re: one word, not "if", for "as long as": From: Laura Lemay
Re: one word, not "if", for "as long as": From: Lauren

Previous by Author: RE: a question for FrameMaker experts
Next by Author: RE: css media types specification
Previous by Thread: RE: one word, not "if", for "as long as"
Next by Thread: Re: one word, not "if", for "as long as"

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

Sponsored Ads