Re: Naming Conventions

Subject: Re: Naming Conventions
From: Michael Loader <softlogik -at- EARTHLINK -dot- NET>
Date: Sun, 11 Aug 1996 15:00:00 -0500

Martyn Thirlway wrote:

> Just to start another discussion, should one say that a window "is
> displayed", "appears", "will be displayed", or what? Personally, I
> think the future tense should not be used, and that "appears" has a
> rather magical ring about it.

FWIW, Apple's Publications Style Guide says "A dialog box appears, or
the application program presents or displays a dialog box."

I usually write either:

"Select an object and choose Information from the Edit menu. The
Object Information dialog box will appear."


"Choose Information from the Edit menu to display the Object
Information dialog box."

While I could write:

"Choose Information from the Edit menu. The Object Information dialog
box will appear."

for the second example so that it was more consistent, I prefer to
adjust the wording to improve readability. I sometimes cheat and don't
use display or appear when dealing with additional dialog boxes to
improve readability. For example:

"Choose Define Colors from the Edit menu to display the Define Colors
dialog box. Click New to create a new color with the Edit Color dialog


Michael Loader
SoftLogik Publishing

TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-

Previous by Author: Forcing WinWord's default paragraph style
Next by Author: Re: User Interface Design
Previous by Thread: Re: Naming conventions
Next by Thread: Re: Query about a technical writing carreer

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

Sponsored Ads

Sponsored Ads