Re: How to name a window in documentation

[voxwoman <voxwoman -at- gmail -dot- com>]

I hope that I never have to use equipment that refers to itself formally as
a "box" (unless it's made out of cardboard and used to hold other things).

are the individual box windows inside the "all boxes" window, or are they
separate? Going under the assumption that these are separate windows, I
would possibly name the various windows the "aggregate window" (for all
boxes) and the "device window" (for each device). I would also consider
using the specific device type, if all the boxes are the same type of
device, for ex, "router window".

HTH
Wendy

On Mon, Nov 3, 2008 at 12:41 PM, Bruce Megan (Telex) <
Megan -dot- Bruce -at- us -dot- bosch -dot- com> wrote:

> 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 voxwoman -at- gmail -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/voxwoman%40gmail.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
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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