Re: Which style to use in this case

Subject: Re: Which style to use in this case
From: Julie Stickler <jstickler -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Mon, 13 Apr 2009 10:46:35 -0400

On Fri, Apr 3, 2009 at 3:13 PM, Downing, David <david -dot- downing -at- fiserv -dot- com> wrote:
> I need to refer to a command that's available as both a button and a menu option.

Microsoft Manual of Style solves the problem by stating "In most
materials, always document the preferred method of performing a
procedure of there is more than one way to do something. The
preferred method should reflect the needs of the audience as much as
possible. For example, the preferred method might be to use menus and
commands, or it might be to use toolbar buttons." (3d edition, page
117)

I've had developers code as many as *three* ways to perform an action
(toolbar buttons, menu options, and keyboard shortcuts), and I've
always just picked one to document. Usually the option that required
the least amount of mouse clicks to accomplish. I'd rather not
confuse the novice user by mentioning two or three different ways to
accomplish the same thing. The more experienced users will figure out
the various options as they become more familiar with the software.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.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/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Which style to use in this case: From: Downing, David

Previous by Author: Re: Before or After
Next by Author: SDL Author Assist and FrameMaker 9?
Previous by Thread: Which style to use in this case
Next by Thread: Re: Which style to use in this case


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

Sponsored Ads


Sponsored Ads