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.
The situation in which these are most useful (IMO) is when your
SW is not localized, but your documents may be. Also, if your
illustration is more of a "what are all these for?" type rather than
a "how to." In our case, there's not much stepping through dialogs
going on, the user selects a command, gets a configuratio dialog,
enters multiple numeric parameters and then hits "OK" to run the
command. Most users who are already familiar with performing
the same operations from the command line usually don't need to
look at the documents, because the parameter fields have the
same names they know from the command line switches (of course,
these users don't need to run the GUI SW, either, which is another
issue altogether around here).
Gene Kim-Eng
"David Chinell" <dchinell -at- msn -dot- com> wrote...
> The only good thing I can say about numbered callouts is
> that they've saved us some heartache with translations. I'm
> sure if we had a better translation methodology we could
> dispense with them, but until we do...
WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo: http://www.webworks.com/techwr-l
Technical Communication Certificate online - Malaspina-University College, Canada. Online training in technical writing, software (FrameMaker, RoboHelp, Dreamweaver, Acrobat), document & web design, writing manuals, job search. www.pr.mala.bc.ca/tech_comm.htm for details.
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.