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.
> 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
> 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
> the sun rises someone will call tech support to complain that the "Open"
> 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
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom
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-