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.
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.
Lauren
> 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. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-