Re: Documenting buttons with ellipses

Subject: Re: Documenting buttons with ellipses
From: Dick Margulis <margulisd -at- comcast -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 18 Jun 2004 10:06:50 -0400




technicoid wrote:



The last time I checked, the Microsoft MoS recommended omitting the
ellipses. I personally doubt many users would be confused by the
omission of the punctuation in that context. Omission of an actual word
would be a no-no.


I'd agree and go a step further. There are situations where the screen control (whether it is a menu item or something else) is rendered in sentence style (initial cap, remainder of words lowercase). I know there are advocates of using a typographic convention such as bold to identify screen controls and keep capitalization the same; but, as I've said before, I prefer to just keep everything in normal type (not italic, not bold) and use initial caps to mark it in the text. So even though all the words (including any abbreviations or other oddities) are the same, the capitalization may not be. I've never gotten a complaint.

Of course, this change should only be at the style guide level; it's not up to the individual writer of an individual document to make the call if you're working in a group or extending an existing series.


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

SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content Management, Multi-Author support, PDF and XML support and much more! http://www.macromedia.com/go/techwrldemo
COMPONENTONE DOC-TO-HELP 7 PROFESSIONAL: From a single set of Word documents, create online Help and printed documentation. New version offers yearly subscription service, Natural Search, Modular TOC Utility, Image Map Editor, Theme Designer, Context String Editor, plus more. http://www.componentone.com/doctohelp .

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



References:
RE: Documenting buttons with ellipses: From: technicoid

Previous by Author: Word choice and "ADD/ADHD" as a social construct
Next by Author: Re: Document CD Catalog
Previous by Thread: RE: Documenting buttons with ellipses
Next by Thread: Networking terminology


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

Sponsored Ads


Sponsored Ads