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.
We had a minor controversy on our techwriting team here
last week, and I told my co-writers that I would poll
y'all to find out your opinions.
We are writing some manuals for a set of Windows-based
applications that will be used by a group of folks
that range from completely new to Windows *and* computers
in general to those of relative sophistication.
We had a sentence that told the user:
"The toolbar buttons trigger commands that are also found
I thought "trigger" sounded too technical -- my coworker disagreed
since you can "trigger" reactions in people. Another writer
suggested "activate" (which also sounds technical). I
suggested "perform" (which I now dislike).
(I have since had an idea to re-write the entire paragraph
to avoid any of the terminology, but still I would like
your opinions on the words.)
FYI - my suggestion for the rewrite:
"Toolbars buttons allow you to select the commands you may use
most frequently without having to go through the menus."
ncrowe -at- primenet -dot- com
rwilc -at- fast -dot- dot -dot- state -dot- az -dot- us
"Half an hour's meditation is essential except
when you are very busy. Then a full hour is needed."
-St. Francis De Sales