RE: Procedural syntax: "Click to expand" vs. "Expand by clicking"

Subject: RE: Procedural syntax: "Click to expand" vs. "Expand by clicking"
From: "Dubin, David" <David -dot- Dubin -at- sage -dot- com>
To: 'Yves Barbion' <yves -dot- barbion -at- gmail -dot- com>, TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 20 Jan 2006 08:46:07 -0500

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.


--
Yves Barbion Technical Writer
Adobe-Certified FrameMaker Instructor
Technical writer
____________________________________




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

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

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy.
Watch the demo at http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as david -dot- dubin -at- sage -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/david.dubin%40sage.com

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

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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/archive%40infoinfocus.com

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.


Follow-Ups:

Previous by Author: RE: Do you have a hybrid job?
Next by Author: RE: Procedural syntax: "Click to expand" vs. "Expand by clicking"
Previous by Thread: Re: Procedural syntax: "Click to expand" vs. "Expand by clicking"
Next by Thread: RE: Procedural syntax: "Click to expand" vs. "Expand by clicking"


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


Sponsored Ads