TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
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.