RE: proper terms/usage

Subject: RE: proper terms/usage
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Gene Kim-Eng" <techwr -at- genek -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 9 Jun 2009 12:08:47 -0600

Gene Kim-Eng wrote:

> I would not feel comfortable staking out a position like this if I
felt I
> lacked
> sufficient knowledge to choose the "correct" term and back up my
choice to
> the
> SMEs without having to first ask the members of a technical writing
> to
> vote on it. Perhaps "Spectrum" feels the same way.

No doubt. But the tech writers who are content to leave it at that have
no business complaining that tech writers get no respect.

IMHO, it's the tech writer's job to _acquire_ sufficient knowledge to
make an informed decision. That can include picking the brains of the
SMEs, doing the kind of research done by several contributors to this
thread, and yes, even querying this list.

I'm responsible for the content and quality of the docs I write --
clarity, accuracy, fitness for purpose, etc. -- and am evaluated partly
on that basis. I don't expect SMEs to provide me with _content_ (except
to the extent that I can rewrite some material they've written for
internal purposes), I want them to help me achieve _understanding_.

There are _countless_ things of which I lack sufficient knowledge,
including many that at some point I have to write about. But I can't
fulfill my responsibilities if I'm content to _remain_ lacking in
sufficient knowledge -- because I can't write clearly about things that
I don't understand.

It's not about laying down the law or playing the language expert card,
either. I'm not suggesting that I'd get on a high horse or be a jerk
about this sort of thing. I'd talk to each SME about their reasoning, do
the research, make a decision -- and then thank them both for helping me

I just don't think a competent, self-respecting tech writer should be in
a position where two SMEs decide between them what the content of the
manual should be, and all the tech writer does is "make it look pretty."


Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom


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:


Re: proper terms/usage: From: Craig Haiss
RE: proper terms/usage: From: Combs, Richard
Re: proper terms/usage: From: Gene Kim-Eng

Previous by Author: RE: proper terms/usage
Next by Author: RE: FrameMaker crashes
Previous by Thread: Re: proper terms/usage
Next by Thread: Re: proper terms/usage

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

Sponsored Ads

Sponsored Ads