RE: Display, Displays, or Appears

Subject: RE: Display, Displays, or Appears
From: "Hemstreet, Deborah" <DHemstreet -at- kaydon -dot- com>
To: "Tim Lewis" <ltc -dot- writer -at- comcast -dot- net>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 5 Jun 2008 15:00:26 -0400

Hi Tim,

I've had this argument with colleagues lots of times.... And usually
won...

1. Click **XYZ** on the Main Menu. (the ** means you would format this
as a command)
The ABC dialog box appears.
2. In the ABC dialog box, click **Update**.
The data is updated... (or whatever.

Rationale:

- brevity - use as few words as possible
> is displayed = 2 words
> appears = 1 word

- accuracy - the dialog box is not only displayed "To show, make visible
or apparent" (it wasn't hidden) - rather, it has appeared "Come into
sight or view" - nothing was there, now something is there. Also,
display can imply to someone that it is there for you to just look at -
not so....

Finally, in my instructions, I avoid descriptive text as much as
possible ("when you click XYZ on the Main Menu screen the"). Again, give
the end-user as little noise (excess verbiage) as possible.

"When you click XYZ on the Main Menu screen the" = 10 words
"Click xxx on the Main Menu" = 6 (I don't think I would use the word
screen either... Just now handled some documentation where there was a
stand-alone main menu - never considered calling it a screen - but your
application could be different)

Don't mean to sound critical, just want to point out that there is far
more to this question than meets the eye.

Hope this is helpful.

Deborah

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

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
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.


Follow-Ups:

Previous by Author: RE: AUTONUMGL except that in Word 2003
Next by Author: RE: Display, Displays, or Appears? <philosophical thoughts>
Previous by Thread: RE: Display, Displays, or Appears
Next by Thread: RE: Display, Displays, or Appears


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


Sponsored Ads