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.
Subject:examples From:"Laurin A. Kinville" <lak -at- CGRAMS -dot- COM> Date:Tue, 25 Aug 1998 11:46:39 -0400
Lisa Comeau asked about the use of cute names, humor, or "real" people in
examples.
I use a consistent theme /company throughout examples (have done this for an
accounting software program and a satellite earthstation monitor and control
system), without any particular effort to be cute or funny. However, the
sample company should be one all can identify with - I refuse to use a
sample company that makes widgets! Use a person / company / theme we can
all identify with. It'll keep your trainees / readers interested, and you
won't have to do as much research to make the situations you discuss more
realistic.
