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
303-223-5111
------
rgcombs AT gmailDOTcom
303-903-6372
------






^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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.

http://bit.ly/doc-to-help

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

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
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

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


Sponsored Ads