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:Re: sanity check and intangibles From:"Susan W. Gallagher" <sgallagher -at- EXPERSOFT -dot- COM> Date:Wed, 28 Aug 1996 11:33:25 -0700
>>Do you know what a
>>veliger is? I didn't, and wanted to change it to a better-understood term
>>(a larval mollusk; now you know!!). Then I found out my audience knew
>>veligers from mollusks like I know my phone number. What I would've
>>thought was helpful would've been perceived as patronizing.
>Thus, by not defining the word, you limit the
>future use of the document or the potential distribution of the document to
>populations familiar with "veliger" -- in this case, concentrated primarily
>in the great lakes region. So, where do we draw the line?
Providing a glossary solves the problem nicely without offending
the knowledgeable reader or slighting the novice. We've got lots
of devices in our collective bags-o-tricks -- like glossaries,
callouts, margin notes. Use them when you need to satisfy more
than just one audience. They work.
sgallagher -at- expersoft -dot- com
-- The _Guide_ is definitive.
Reality is frequently inaccurate.
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-