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.
How do you handle: Identical commands having a variety of titles? ?
Subject:How do you handle: Identical commands having a variety of titles? ? From:Jane Post <Jane -at- asconline -dot- com> To:"'TECHWR-L'" <TECHWR-L -at- LISTS -dot- RAYCOMM -dot- COM> Date:Fri, 17 Dec 1999 11:09:29 -0500
In our application, we have both a toolbar plus pull-down and shortcut
menus. A command might occur on any or all of these, but do not always
appear with the identical title. For instance, STATS appears on the toolbar
but appears as POOL STATISTICS in the menus.
The developers must use the brief name on the toolbar as a longer name can't
be displayed. I list the commands for each window with a popup providing an
explanation of the command.
I've recommended that only 1 title be used for a command....but that fell on
deaf ears.
QUESTION:
Would you list BOTH the long and short form (STATS, POOL STATISTICS or would
you use STATS, see POOL STATISTICS to reference the command.
NOTES: There are instances when 3 titles reference the same command
(STATISTICS, COLUMN STATISTICS, RESULT STATISTICS), and also instances where
a command having only 1 title performs differently depending on where it was
accessed.