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.
Passive voice can create problems if you want to create procedural
documentation with hand-offs from one "role" to another.
We typically create procedures for use cases and requirements, where there
must be an actor specified for each action. For example, when I have text
(from an SME) to use that says "the file is completed, then sent to
storage," and three departments are involved, I can't say who completes the
file. I have to stop and go ask. :-/
In other documents, we do use passive voice if it is shorter, just because
anyone can or will do the action. I do *try* to avoid it, but since I mainly
edit rather than author work here, I don't always get to say.
In ordinary procedures, it is second person, present tense if I get my way.
:-)
My $.02.
PT
On 3/15/07, Brierley, Sean <Sean -dot- Brierley -at- ipc -dot- com> wrote:
>
> The argument is not, never use the passive voice.
>
> The argument is, in the main, for mainstream U.S. technical
> communication, use the active voice because it's more concise than the
> passive voice.
>
> This is not a prohibition against using the passive voice, just a
> general recommendation that you use the active voice more often than the
> passive voice.
>
> Cheers,
>
> Sean
>
> -----Original Message-----
> From: techwr-l-bounces+sean -dot- brierley=ipc -dot- com -at- lists -dot- techwr-l -dot- com
> [mailto:techwr-l-bounces+sean -dot- brierley=ipc -dot- com -at- lists -dot- techwr-l -dot- com] On
> Behalf Of Fred Ridder
> Sent: Thursday, March 15, 2007 11:50 AM
> To: suzette -dot- leeming -at- gmail -dot- com
> Cc: techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: Re: Escaping gender usage (was RE: Pet Peeves)
>
> Ah, but if you do that, a different faction of the language police will
> condemn you for using the passive voice because some teacher or editor
> in thier past insisted that the passive voice should never be used under
> any circumstances.
>
> And it seems to me that the passive voice is even more impersonal than
> "the user" because it completely eliminates the doer of the action.
>
>
>
> DISCLAIMER:
> Important Notice *************************************************
> This e-mail may contain information that is confidential, privileged or
> otherwise protected from disclosure. If you are not an intended recipient of
> this e-mail, do not duplicate or redistribute it by any means. Please delete
> it and any attachments and notify the sender that you have received it in
> error. Unintended recipients are prohibited from taking action on the basis
> of information in this e-mail.E-mail messages may contain computer viruses
> or other defects, may not be accurately replicated on other systems, or may
> be intercepted, deleted or interfered with without the knowledge of the
> sender or the intended recipient. If you are not comfortable with the risks
> associated with e-mail messages, you may decide not to use e-mail to
> communicate with IPC. IPC reserves the right, to the extent and under
> circumstances permitted by applicable law, to retain, monitor and intercept
> e-mail messages to and from its systems.
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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. http://www.DocToHelp.com/TechwrlList
>
> Now shipping: Help & 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 & Manual: http://www.helpandmanual.com
>
> ---
> You are currently subscribed to TECHWR-L as pro -dot- techwriter -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>http://lists.techwr-l.com/mailman/options/techwr-l/pro.techwriter%40gmail.com
>
>
> 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
>http://www.techwr-l.com/techwhirl/ for more resources and info.
>
>
--
PT
pro -dot- techwriter -at- gmail -dot- com
I'm a Technical Technical Writer!
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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. http://www.DocToHelp.com/TechwrlList
Now shipping: Help & 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 & Manual: http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-