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_
(http://www.geoff-hart.com/books/eoe/onscreen-book.htm)

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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


Follow-Ups:

References:
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


Sponsored Ads