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.
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:"Crimmin, Peter" <Peter -dot- Crimmin -at- nuance -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Mon, 2 Feb 2009 11:57:54 -0500
Seems to me this thread discusses two issues:
* The policing of jargon. Who gets to decide?
* Quality of the writing. Is the jargon appropriate to the audience?
This implies the following matrix with regard to jargon:
* High quality writing - well-advised jargon used with intention.
* Quality writing - well-advised jargon used without intention.
* Mediocre quality writing - questionable jargon used with or
* Poor quality writing - ill-advised jargon.
Writers need to filter jargon as it arrives from various sources.
Marketing organizations insist on branding, new technologies require
public-domain vocabularies, and in-the-trenches engineers contribute
jargon that might be idiosyncratic and esoteric.
Steven Jong stevefjong at comcast.net
Stuart Burnfield wrote:
> even if ["fraudster"]
> it were a made-up word, your company has every right to
> invent it and the product manager is entitled to make sure
> that its usage in your manual and the marketing material
> reinforce each other.
I didn't disagree at the time, and I'm not disagreeing now. But you do
realize, don't you, that you've just ceded the entire jargon argument?
Any bizarre coinage, spelling, usage, or capitalization can similarly
be claimed as a deliberate invention. Yikes!
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-