TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I try to stay away from naming Windows' parts in my documentation. How about
you lump dialog boxes, windows, and anything similar under "window" and
forms as "data window" (I write "form" though ;?). This goes further, a
drop-down list box and combo box become a "drop-down box," command and other
types of buttons become "button," and so forth. Forget the added complexity
and confusion that your boss adds, "applet versus window versus view,"
indeed. The point here is to document the software, not windows terminology.
Standardizing on broad terms might be technically inaccurate, in some cases,
but it achieves the goal of communicating what you need, rather than
sean -at- quodata -dot- com
> -----Original Message-----
> From: Becca Price [SMTP:becca_price -at- yahoo -dot- com]
> In side the general application window, one can open thingies that I'm
> told are "forms." Nobody here seems to like my calling them "forms"
> however, because we write finaicial software and our users tend to
> think of forms as something you fill out once and submit. Some of the
> topics I've inherited call these thingies windows. Others call them
> dialogs. Some topics make a distinction between these aplet thingies
> and dialog boxes such as the Password dialog. Other topics don't.
> My boss really doesn't seem to want me to call the thingies the aplets
> appear in "windows." She suggests "views" which I'm not sure anyone
> would understand what I meant.
> What do you call these thingies in your documentation?
> who just started Tai Chi lessons and is *really* sore...