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.
>Amazingly enough we are now in a bit of a quandary as to what to call a
>simple screwdriver. Suggestions include
> standard screwdriver
> slotted screwdriver
> straight slot screwdriver
>for one type and
> Phillips screwdriver (which is like the Allen wrench scenario)
> crosshead screwdriver
> x-head screwdriver
> cross slot screwdriver
I like the idea of the screw-head icon representing the correct type, but
my other choice would be to use the terms "straight slot screwdriver" and
"cross slot screwdriver." They are the most accurately descriptive.
Whatever choice you make, you might want to indicate them in a section
right at the beginning stating the conventions used in the manual.
In manuals where I've used such a section, (conviently titled "Conventions
Used In This Manual") it's included descriptions/definitions of icons used
(warnings, cautions, etc.), and special terms or layout issues (...words in
BOLD ITALIC in this manual can also be found in the glossary...) or
whatever else you feel your reader needs to know before jumping in.
Carla Martinek (carlam -at- opentext -dot- com) | Visit the Open Text
Open Text USA, Inc. | WWW Search Engine
business intranet solutions | at http://www.opentext.com/ http://www.opentext.com | omw/xpowrsrch_c.html
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-