RE: Advice on rewriting translated ops manuals

Subject: RE: Advice on rewriting translated ops manuals
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Porrello, Leonard" <lporrello -at- illumina -dot- com>, Techwr-l <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 25 Jun 2013 10:42:46 -0700

Porrello, Leonard wrote:

> On a side note, why does your style guide avoid "you", and how would you
> rewrite your examples without resorting to the passive voice? (Disclaimer: I
> have nothing against the passive voice when it is used judiciously, and am not
> looking to debate the issue.)

And an important side note it is. The two example sentences Anonymous cited are fine as they are. Any attempt to rewrite them to eliminate "you" is bound to make them less readable and clear. The silly notion that we shouldn't address the reader is so 1980s! :-)

Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-903-6372
------






^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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:
Advice on rewriting translated ops manuals: From: Anonymous
RE: Advice on rewriting translated ops manuals: From: Porrello, Leonard

Previous by Author: RE: Numbered versus unnumbered heads in very technical reference guides
Next by Author: Re: A softer word for "honesty" or "integrity" ?
Previous by Thread: RE: Advice on rewriting translated ops manuals
Next by Thread: Re: Advice on rewriting translated ops manuals


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

Sponsored Ads


Sponsored Ads