Re: Open...

Subject: Re: Open...
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: "tw list" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 18 Nov 2010 08:10:47 -0800

What we do is look at our tech support call logs. If your goal is for your
documentation to minimize calls, you base what you do on how your customers are
actually reading and interpreting docs and not on what "major vendors" and other
companies' style guides say. Not even on what you think your customers should

Gene Kim-Eng

----- Original Message -----
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>

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.


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.

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

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:

Open...: From: Anon TWer
Re: Open...: From: Richard Mateosian
Re: Open...: From: Gene Kim-Eng
RE: Open...: From: Combs, Richard

Previous by Author: Re: Open...
Next by Author: Re: Open...
Previous by Thread: RE: Open...
Next by Thread: RE: Open...

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

Sponsored Ads