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.
Personally, I like [A] because it is in active voice. I am strongly against
the flagrant use of passive voice in technical communications. Since most
technical communications with regard to software and/or hardware is designed
to instruct the user how to do something, I believe it is best to speak to
the user/learner in the same voice as you would if he/she were in front of
you.
David B. Dubin, PHR
Senior Curriculum Developer
Sage Software
727-579-1111 x 3356
david -dot- dubin -at- sage -dot- com
Your business in mind.
-----Original Message-----
From: techwr-l-bounces+david -dot- dubin=sage -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+david -dot- dubin=sage -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf
Of Yves Barbion
Sent: Friday, January 20, 2006 8:21 AM
To: TECHWR-L
Subject: Procedural syntax: "Click to expand" vs. "Expand by clicking"
Hello techwhirlers,
just wondering, which do you prefer (and why):
[A] Click the plus sign to expand the folder.
OR
[B] Expand the folder by clicking the plus sign.
Any references to style guides, maybe? I checked the Microsoft Style
Guide for Technical Pubs (Procedural syntax) but did not really find an
answer there.
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l