Re: WG: Newbie question - GUI terminology

Subject: Re: WG: Newbie question - GUI terminology
From: Janice Gelb <janice -dot- gelb -at- sun -dot- com>
To: Techwriter <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 10 Oct 2006 07:32:07 +1000

Dick Margulis wrote:

Chinell, David F (GE Indust, Security) wrote:

Sorry to quibble with your otherwise typically sage advice, but "dialog" in place of "dialog box" is not a generally accepted convention as far as I'm concerned. The MS MoS is pretty clear on this, and it's not something I've ever taken exception to.

We may be talking about different scenarios. If someone points to a dialog box and asks, "What do you call this kind of control?" the answer is "dialog box." If I'm telling someone how to change an option, I'm going to write, "On the Options dialog, click the View tab" rather than "On the Options dialog box, click the View tab." Actually, I'd probably avoid the word altogether: "1. On the Tools menu, click Options. 2. Click View."

I think if you're naming the dialog (by way of directing the user's attention to the right region of the display), the word box is just redundant clutter.


In your original message about this, you said "It's
"dialog," not "dialogue box" (by general convention)."
You have a perfect right to decide for yourself and
your company that "box" is redundant clutter and you're
not going to use it when you write. But saying that
eliminating the word "box" from the term "dialog box"
is a "general convention" is misleading. As David
pointed out, the Microsoft Manual of Style uses "dialog
box" and, for the record, so does Sun.

-- Janice

***********************************************************
Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help format plus PDF, HTML and more. Flexible, precise, and efficient content delivery. Try it today! http://www.webworks.com/techwr-l

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

References:
RE: WG: Newbie question - GUI terminology: From: Chinell, David F \(GE Indust, Security\)
Re: WG: Newbie question - GUI terminology: From: Dick Margulis

Previous by Author: Re: Weird words
Next by Author: Re: Open vs Appear,Yet Again
Previous by Thread: Newbie question - GUI terminology
Next by Thread: Re: WG: Newbie question - GUI terminology


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


Sponsored Ads