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.
(Lucky choices.)
* Mediocre quality writing - questionable jargon used with or
without intention.
* 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

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.

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!

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

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:


Previous by Author: RE: Software Reviewer's Guide?
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

Sponsored Ads