RE: Microsoft Manual of Style questions

Subject: RE: Microsoft Manual of Style questions
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: 'Dan Goldstein' <DGoldstein -at- riverainmedical -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 22 Apr 2010 07:41:35 -0700

Dan Goldstein wrote:

> Just to clarify, MMOS 3 doesn't consider any of those terms acceptable
> for home users and information workers. They write: "In most content,
> especially for home users and information workers, do not differentiate
> between drop-down combo boxes, list boxes, and text boxes. Refer to such
> elements by their label, and use a descriptor only if necessary for
> clarity. If you must use a descriptor, use list or box. Do use the term
> check box, however." So their intention is that you would use those
> terms when communicating about the GUI with a developer, not when
> describing the GUI to an end user.
>
> They give the example, "In the Item list, click Desktop."

The prescription is fleshed out a bit, but the example is the same as in 1998.

> By the way, their instruction not to use the term "check box" is
> confusing. Every one of their check box examples uses that term! Maybe
> they meant that you shouldn't use the term for something that isn't a
> check box...?

You read too quickly (and the construction lends itself to misreading). It says "_Do_ use the term check box, however."


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






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

Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial: http://www.doctohelp.com


- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -


---
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:
Microsoft Manual of Style questions: From: Jodie Gilmore
RE: Microsoft Manual of Style questions: From: Zuercher, Darrell
RE: Microsoft Manual of Style questions: From: Dan Goldstein

Previous by Author: RE: Microsoft Manual of Style questions
Next by Author: RE: Microsoft Manual of Style questions
Previous by Thread: Ork (was RE: Microsoft Manual of Style questions
Next by Thread: RE: Microsoft Manual of Style questions


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


Sponsored Ads