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: Taking active vs. passive voice too far From:Kathleen MacDowell <kathleen -dot- eamd -at- gmail -dot- com> To:M -dot- Vina-Baltsas -at- mindray -dot- com Date:Tue, 9 Jul 2013 11:09:36 -0500
I agree with Lynne and Duane about how to phrase things; otherwise it takes
extra effort to figure out "Access List Trends." While that's probably not
too confusing, other situations might be worse.
I agree with Mike too. But the main issue is how much time do you have to
make these changes and what the company wants done? While I've had
situations where I didn't receive clear directions from a manager, I still
had to consider other workload and how much time would be required for a
re-do, along with how important any facet would be. So you might be better
off doing a complete change, or you might be better starting with specific
aspects of the document. Decide what is most important to set standards
about, perhaps for the time being.
Kathleen
On Tue, Jul 9, 2013 at 9:45 AM, <M -dot- Vina-Baltsas -at- mindray -dot- com> wrote:
> I'm working with a manual that was primarily written in the passive voice.
> I'm struggling with how far I should go with my edits. No, there is no
> style guide, and as a result, there are many inconsistencies throughout
> the manual. Please see the examples below and tell me if you think I'm
> going too far with active vs. passive voice.
>
> Topic heading:
> List Trends
> List Trends can be accessed by selecting the History button from the Main
> Screen.
>
> or
>
> Topic heading:
> List Trends
> Access List Trends by selecting the History button from the Main Screen.
>
> ________________________________________________________________
>
> Michelle ViÃa-Baltsas
>
>
>
> m -dot- vina-baltsas -at- mindray -dot- com
>
> STRICTLY PRIVATE & CONFIDENTIAL.This email may contain confidential and
> proprietary material for the sole use of the intended recipient. Any
> review or distribution by others is strictly prohibited. If you are not
> the intended recipient please contact the sender and delete all copies.
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> 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 kathleen -dot- eamd -at- gmail -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
>
--
Kathleen MacDowell
kathleen -dot- eamd -at- gmail -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.