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: Not Wanted--Technical Writers From:Sean Fitzpatrick <Sean -dot- Fitzpatrick -at- SMED -dot- COM> Date:Tue, 16 Dec 1997 11:49:15 -0500
EXAMPLE ONE
How to log on at a product call center.
BEFORE: Before a call arrives, a call center agent must be logged on and
available to receive that call. In addition, a supervisor responsible for that
agent's performance is typically logged on. When the supervisor and the agent
sign on, their devices (telephones or PCs) establish a X.25 virtual circuit to
the Call Distribution System. This connection will be in place for the
duration of the time the agent/supervisor is logged on. When the agent logs
on, a data connection to the corporate host database may also be established.
AFTER: A call center's supervisor and agent log on to the Call Distribution
System, establishing a connection that can last throughout the workday.
===================================
I'm insulted. The Before examples is clearly from the programmers' specs.
Any technical writer who wrote Example 1 for the intended audience deserves to
be not wanted.
