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.


Previous by Author: Re: Validating Technical Procedures
Next by Author: Top 10 things to do now that you're laid off
Previous by Thread: Re: Rule about not using possessive? (Take III, and out)
Next by Thread: Re: Damnit Jim, I'm a Writer, not a Programmer II: The Wrath of Kahn


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


Sponsored Ads