Re: I had say it because I was afraid no one else would.

Subject: Re: I had say it because I was afraid no one else would.
From: "Downing, David" <DavidDowning -at- users -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 30 Jan 2009 08:28:52 -0600

From: CL T <straylightsghost -at- gmail -dot- com>
Subject: I had say it because I was afraid no one else would.

One paragraph from this is especially true.

FROM THE DESK OF DAVID POGUE
Tech Terms to Avoid
"Why tech writers use so much jargon, I don't know. Maybe it's
self-aggrandizement; they want to lord their knowledge over everybody
else.
Maybe it's laziness; they can't be bothered to fish for a plain-English
word. Maybe it's just habit; they spend all day talking shop with other
nerds, so they slip into technospeak when they write for larger
audiences."

http://www.nytimes.com/2008/10/16/technology/personaltech/16pogue-email.
html?_r=4&8cir=&oref=slogin&emc=cira1&pagewanted=all&oref=slogin

I've got to say, I agree.

Thoughts?

-Collin

---------

I try, whenever possible to translate jargon into common, everyday
English, but I've had the experience of having SMEs who are reviewing my
documents get upset with me for doing so and insisting that I use the
jargon.

I think it's a variation on a more general phenomenon I have
encountered. Some people get mad at you if you paraphrase anything they
say because they think you're trying to change their meaning, as opposed
to clarifying it.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Previous by Author: Re: How do I document vaporware?
Next by Author: Re: I had say it because I was afraid no one else would.
Previous by Thread: RE: I had say it because I was afraid no one else would.
Next by Thread: Re: I had say it because I was afraid no one else would.


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


Sponsored Ads