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: Re: Is this too Offensive for a manual? From:"Gene Kim-Eng" <techwr -at- genek -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:20 Nov 2003 21:02:04 GMT
Since the software in question is a personnel management
tool, "management concepts" are unavoidably linked to its
use. Foreseeing the potential unintended consequences of
the use of certain phrases in the instructions if they
should become known by the people being managed is as much
a part of documenting "mangement" software as foreseeing
the potential effect of providing technical data that
unnecessarily exposes product IP that should not be widely
disseminated. The client is paying for documentation that
enhances effective product function, use and avoids
undesirable consequences, and the writers producing that
documentation should be aware of the results the formats
they employ may produce. "Know your product/user/
application" is just as important - if not more so - if
the documentation involves people instead of technology.
Gene Kim-Eng
------- Original Message -------
On
Wed, 19 Nov 2003 20:36:45 -0800 (PST) Andrew Plato?wrote:
That much said - are you instructing them on management concepts or how to use software?
RoboHelp for FrameMaker is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to online Help, intranet, and Web.
The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! Call 800-718-4407 for
competitive pricing or download a trial at: http://www.ehelp.com/techwr-l4
---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
