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:Correct Wording--twist in subject From:"Hamilton, Susan" <shamilton -at- METASOLV -dot- COM> Date:Mon, 25 Nov 1996 08:59:37 -0600
I realize I'm a little behind on this discussion, but I just got this
thread about correct wording for examples.
>Is it correct that we generally shouldn't use abbreviations like "e.g."
>and "i.e." in order to avoid giving the user any extraneaous terms that
>cause the reader to process more info than they must already?...
Am I the only one who has noticed that almost every person who responded
had *the* correct way to write the example. "You should do...This is how
you do..." I didn't even agree with several of the responses, which I
think were grammatically incorrect.
If I try hard enough, I can find several acceptable ways to write almost
everything (barring a few instances where there is a definite right and
wrong way). And for someone to respond with the implications that their
solution is the best and only way to do something seems a little out of
place in a profession that is far from being an exact science.
I like the discussions on this list, and I find a lot of helpful
information on a wide variety of subjects; there are a ton of very
knowledgeable and experienced tech writers out there. I apologize if
I've offended anyone, but I just had to get this off my chest.
Susan Hamilton
>----------------------------------
>MetaSolv Software, Inc.
>Susan Hamilton
>shamilton -at- metasolv -dot- com
>14900 Landmark Suite 530
>Dallas, Texas 75240
>http://www.metasolv.com
>(972) 239-0623 x172
>----------------------------------