RE: Pet Peeves

Subject: RE: Pet Peeves
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Diane Brennan" <dalaine00 -at- yahoo -dot- com>, "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 15 Mar 2007 14:11:57 -0600

Diane Brennan wrote:

> I've been doing technical writing since 1991. Context is key.

Quite correct, youngster.

> >>In the original, it's perfectly clear.
> It isn't any clearer than the above examples.

But we were discussing a specific edit -- replacing "his" with "the" --
in a specific sentence. The question at hand was, "Which is better,
example A or example B?" I maintain it's A.

Your examples are clear, I agree. But your context is procedures for
accomplishing tasks. The sentence in question is descriptive prose --
"John set his user settings" -- not procedural or task-oriented. Wrong


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


Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

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: Pet Peeves: From: Diane Brennan

Previous by Author: RE: What do I call this doodad?
Next by Author: RE: Pet Peeves
Previous by Thread: Re: Pet Peeves
Next by Thread: Re: Pet Peeves

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

Sponsored Ads