RE: Definition of Tech Writer, was STC is broken

Subject: RE: Definition of Tech Writer, was STC is broken
From: "Lauren" <lauren -at- writeco -dot- net>
To: "'Gene Kim-Eng'" <techwr -at- genek -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 14 May 2008 15:05:24 -0700

As a consultant, I rarely work with a group of writers. My work usually
involves documentation for a specific project that does not have other
writers. However, I have worked with other writers two or three times.

On one occasion, I had a contract to work with a group of technical writers.
The lead there told me of an issue the group had in developing the
convention for the use of "or" in a bulleted list when either of a pair of
bulleted items were options. The possible conventions were to offset "or"
in all uppercase, bold, with asterisks on either side, with hyphens on
either side, with italics, or with any combination of the options.
Apparently, the debate went on for some time and a special meeting was
called that lasted several hours. I don't recall how they resolved the
issue or what they ultimately decided to use, but I think there was some
management intervention to end the debates.

Personally, I do think that these people were communicating, but they
weren't accepting the views of others or willing to compromise or re-define
their views in the interests of the project. Although, they were
communicating, they weren't *effectively* communicating, which would involve
the incorporation of the views of others.


> From: Gene Kim-Eng

> I have spent endless hours in meetings with writers
> who could produce excellent documentation yet could
> not seem to conduct simple conversations with one
> another without mediation. This too is communication.
> Gene Kim-Eng


Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

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.

Re: Definition of Tech Writer, was STC is broken: From: Gene Kim-Eng

Previous by Author: RE: MS Word Text Form Fields
Next by Author: RE: MS Word Text Form Fields
Previous by Thread: Re: Definition of Tech Writer, was STC is broken
Next by Thread: RE: Definition of Tech Writer, was STC is broken

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

Sponsored Ads