How to name a window in documentation

Subject: How to name a window in documentation
From: "Bruce Megan (Telex)" <Megan -dot- Bruce -at- us -dot- bosch -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 3 Nov 2008 11:41:11 -0600

Hello All,
I am in a bit of a quandary.... I am trying to write Screen descriptions
for a software application. Easy enough you may say,....well here's
where it gets a bit tricky:
A little background - The software I am working with is specific to the
hardware it is hooked up to. For example, Box A (aliased New York) can
talk to Box B (aliased Los Angeles) can talk to Box C (aliased Akron)
and so on and so forth, due to t h! is software. If I select the option
All Boxes, the window caption shows "All Boxes" and displays all the
pertinent information for every box in the system. However, if I select
a specific box, the window caption says New York Box, Los Angeles Box,
or Akron Box.
My question is as follows:
"Because the window showing all the boxes displays different
information, than the window that displays the individual box, how do I
go about giving a generic term to the specifically chosen box?"
I don't like using XXXX Box (where XXXX represents the alias of the box)
Does anyone have any suggestions on how to get around this?
Thanks in advanced.
Megan
Megan Bruce
Documentation Specialist - ST-CO/ENG2.2
Bosch Communications Systems
Telex Communications Inc.
12000 Portland Ave. S.
Burnsville, Minnesota 55337
USA
www.boschcommunications.com <http://www.boschcommunications.com/>


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

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! 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.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

Previous by Author: RE: FW: the old insure ensure assure
Next by Author: RE: How to name a window in documentation
Previous by Thread: Re: TECHWR-L Digest, Vol 37, Issue 2
Next by Thread: Re: How to name a window in documentation


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


Sponsored Ads