RE: Open...

Subject: RE: Open...
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: Gene Kim-Eng <techwr -at- genek -dot- com>, tw list <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 17 Nov 2010 22:23:36 -0800

Gene Kim-Eng wrote:

> I think the real question is what point there is putting it in the UI. An
> "Open" button without an ellipsis already is an obvious link to some other
> menu
> or dialog and the ellipsis is redundant. But once the "Open..." button is
> there, the manual description of it needs to name it precisely, or as sure
> as
> the sun rises someone will call tech support to complain that the "Open"
> button
> described in the manual isn't there, just one that says "Open..."

I agree that an "Open" menu item or button doesn't need or deserve an ellipsis. But as for including the ellipsis in the manual, I recommend that you and Tony do as I suggested: Look at the menus in practically any popular software program from a major vendor, and you'll see many commands that use (properly, in most cases) ellipses to indicate that they open a dialog box for additional user input. Now look at the manual or online help for those programs. I bet you'll be hard-pressed to find examples that include the ellipses.

For the reasons I and others have mentioned, the docs should simply use the button or menu item names, and not extraneous matter like ellipses, keyboard shortcuts, or ending punctuation.

"It's my opinion and it's very true." :-)


Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-903-6372
------






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

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.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


Follow-Ups:

References:
Open...: From: Anon TWer
Re: Open...: From: Richard Mateosian
Re: Open...: From: Gene Kim-Eng

Previous by Author: RE: Open...
Next by Author: RE: FM needs grey text
Previous by Thread: Re: Open...
Next by Thread: Re: Open...


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

Sponsored Ads


Sponsored Ads