Re: Industry jargon OK in marketing docs?

Subject: Re: Industry jargon OK in marketing docs?
From: Kathleen MacDowell <kathleen -at- writefortheuser -dot- com>
To: Julie Stickler <jstickler -at- gmail -dot- com>
Date: Tue, 11 Aug 2009 10:50:50 -0500

This is an interesting question. I'm not a marketing specialist, but I think
I'd approach the issue by talking to the client. Questions might be:

Is the material directed at a highly specific audience where the terminology
would be the most or best recognized term? Much as I'd tend to agree with
your initial reaction, what seems like jargon to me is often found in
materials aimed at specialized audiences, such as software engineers, versus
what would be found for basic "user" materials.

More generally, do they "feel" that the terminology is necessary, and why.

Who's returning the materials to you? Is it someone who should be making the
final judgment, or perhaps someone who just happened to notice your change
and isn't in the decision loop?


On Tue, Aug 11, 2009 at 9:43 AM, Julie Stickler <jstickler -at- gmail -dot- com> wrote:

> While I'm out of work I'm doing some contracting for previous
> employers. Last week I formatted some marketing docs for the place
> that I used to work a year ago. The text had already gone through
> several edits (that I wasn't involved in) so since I was mostly hired
> to format it in InDesign and generate a PDF, I only fixed one glaring
> error, changing "contractor spend" to "contractor spending."
> Today I recieved an e-mail asking for the following "Change âspendingâ
> back to âspendâ for phrases like âcontractor spend.â This is industry
> jargon."
> Arggghhhh! I was always taught to remove jargon from my docs. But
> then I have done mostly software manuals and help, I haven't had much
> experience writing marketing documents. One the one hand I'm thinking
> that since I'm contracting, the customer is always right. If that's
> what they want, that's what I should give them. On the other hand,
> gramatically incorrect jargon makes me cringe.
> So I ask you, TECH-Wrlers, do you include industry jargon in your
> marketing docs?
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Kathleen MacDowell
kathleen -at- writefortheuser -dot- com
kathleen -dot- eamd -at- gmail -dot- com

Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.

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:


Industry jargon OK in marketing docs?: From: Julie Stickler

Previous by Author: Re: Technical writer survey: What should we really call ourselves?
Next by Author: Re: Have some suggestions about Word?
Previous by Thread: Industry jargon OK in marketing docs?
Next by Thread: Re: Industry jargon OK in marketing docs?

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

Sponsored Ads