I had say it because I was afraid no one else would?

Subject: I had say it because I was afraid no one else would?
From: Geoff Hart <ghart -at- videotron -dot- ca>
To: Technical Writing <techwr-l -at- lists -dot- techwr-l -dot- com>, CL T <straylightsghost -at- gmail -dot- com>
Date: Thu, 29 Jan 2009 11:39:12 -0500

Collin reports: <<"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'd wonder whether this is true of all the docs he reads, or just for
the large proportion that are not actually created by techwhirlers
like us. It's certainly true that a large proportion of the materials
I see coming across my desk are written by amateurs with no training
or expertise in the subject, including a great many engineers who are
forced to write in their second or third language because their
employer is too cheap to hire a translator.

That being said, it's also true that some of us need a bit more
practice remembering our audience's needs. It's also true that some of
what we're documenting is inherently technical, and you can't describe
it without using jargon appropriately.

Geoff Hart (www.geoff-hart.com)
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
***Now available*** _Effective onscreen editing_


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.

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:


I had say it because I was afraid no one else would.: From: CL T

Previous by Author: Productivity Gains?
Next by Author: Importance of documentation, redux
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