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.
> So, how do y'all deal with documenting several different ways of
> accomplishing the same task?
We've just started using a new method. We give each command an 'official
command name' which is similar to the menu item name. Each time we refer
to the command we say something like "Choose the Tickle the Bunny
command", and in the sidehead margin we stick a Little Blue Table (tm)
which contains all the ways of accessing the command. So far we like it
because it makes writing procedures much simpler and it lets users pick
the method they prefer.
Anne
--
A Magee, Technical Writer
magee -at- caris -dot- com
Core Division
CARIS
Telephone: 1.506.458.8533 Fax: 1.506.459.3849 http://www.caris.com/
