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.
Damnit Jim, I'm a Writer, not a Programmer II: The Wrath of Kahn
Subject:Damnit Jim, I'm a Writer, not a Programmer II: The Wrath of Kahn From:Andrew Plato <intrepid_es -at- yahoo -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 6 Jul 2001 13:50:37 -0700 (PDT)
> I'm just annoyed by tech writers who defer their
> own unique abilities to those of developers, especially to the point of
> being afraid that not knowing how to program somehow makes them second
> class. Or that being able to makes them superior to the rest of us.
Not
> accusing you, Anne, but I have seen that attitude displayed fairly
> frequently over the last three years that I've subscribed to the list.
I think the problem here is the class of writers who see their mastery of
English or usability as their sole talent. Most companies simply do not
value this skill as highly as they value writers who have more extensive
technical skills - such as programming.
If you consider that our profession has two core skill sets (shown in
order of importance):
1. TECHNICAL
2. COMMUNICATION
You have to be good at BOTH. Now, at your company, the TECHNICAL portion
of your job might be to analyze business rules or change design user
interfaces. Super - that's how it works at your company. However, the
technical component of the job at other corporations is much different.
Some companies want writers who can read code. Others settle for trained
monkeys. If you want a job at a company that demands technical prowess,
don't be offended when they ask you to interpret some code.
I make writers take a nasty technical test when they apply - many bomb the
test completely. Although my criteria for hiring involves many factors
(which are not up for debate), the test factors into everything.
What bother a lot of us - especially me - is the writers who focus
virtually all their energy on the WRITING side of their profession to the
point of denying and even being openly hostile toward the TECHNICAL side
of their job.
How would you like a lawyer who loved to argue cases - but didn't feel it
was necessary to be knowledgeable about the laws relevant to his
arguments? Would you trust any argument from such a lawyer?
Why then should anybody trust documentation from writers who cannot or
will not learn the technical aspects of their job? Moreover, just
grazing the surface is not enough. If you don't know how things work you
cannot accurately describe how to use them.
Or as Tyler Durden says: Sticking feathers up your butt does not make you
a chicken.
------------------------------------
Andrew Plato
President / Principal Consultant
Anitian Corporation
(503) 644-5656 office
(503) 201-0821 cell http://www.anitian.com
Yahoo Messenger: Anitian
------------------------------------
__________________________________________________
Do You Yahoo!?
Get personalized email addresses from Yahoo! Mail http://personal.mail.yahoo.com/
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com
TECH*COMM 2001 Conference, July 15-18 in Washington, DC
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com
---
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.