Re[2]: Writing: better or worse after years on the job?

Subject: Re[2]: Writing: better or worse after years on the job?
From: CHRISTINE ANAMEIER <CANAMEIE -at- email -dot- usps -dot- gov>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 18 Oct 2001 12:42:26 -0400


>With my books I use the technical jargon and terms...
>for an example - I may use the term launch or taskbar or
>whatever...but I always explain the term I am using. Most
>all my books come with a glossary in the back of the book
>as well.

"Taskbar" I don't object to, since there's not a clear, simpler
alternative available... but for "launch" I would use "open" or
"start."

I first heard "launch the application" in a development department and
my first thought was, "Man, these guys sure have an inflated sense of
their own importance. This is a piece of software, not the space
shuttle."

If I use a slightly jargony term like Taskbar, I try to accompany it
with an illustration, at least the first time it appears. It's hard
enough to get users to read a manual, much less the glossary of a
manual--especially if the user's in the middle of a task and they're
looking for help. Their reaction to an unfamiliar term like "radio
button" won't be "I'd better brush up on my terminology; where's the
glossary..."--it'll be "Why can't they write this #$^&* thing in
English!"

Christine
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit http://ieeepcs.org/2001

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: Re: Writing: better or worse after years on the job?
Next by Author: Re[2]: Most Impt. Skill to Learn in Tech Comm Program?
Previous by Thread: Re: Writing: better or worse after years on the job?
Next by Thread: RE Writing: better or worse after years on the job?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads