Re: A technique to get on development's good side

Subject: Re: A technique to get on development's good side
From: John Posada <jposada01 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 13 May 2005 09:53:01 -0700 (PDT)


> Short of certification, which I support in principle, but doubt in
> practice, there's always the possibility to ask questions about
> basic TW tasks and domain-specific about the technology to be
> documented.

if I'm hiring a technical writer, I don't want basic. I want "take a
function by the horns and document the crap out of it" type of
writer.

If you ask for basic, you'll get basic. Taking a blank screen and an
application with nothing written about it is not basic. Interviewing
a SME about an obscure feature is usualy not basic.

That's where they fall on their feet.

"Ms. Prospective Writer...can you rewrite this paragraph?" - That's
NOT what I want.

How about "Ms. Prospective Writer...meet Crusty Norm. He hates
writers...he thinks they are a waste of time. Ask him about the
module he wrote last night at 2am for a 9am release and hand in a 3/4
page document on how it interfaces with the X, Y, and Z database
tables." That's who I want and who I know will have a better chance
of surviving.

John Posada
Senior Technical Writer

?Never be afraid to try something new. Remember that a lone
amateur built the Ark. A large group of professionals built
the Titanic.? - Dave Barry

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

New from Quadralay Corporation: WebWorks ePublisher Pro!
Completely XML-based online publishing. Easily create 14 online formats, including 6 Help systems, in a streamlined project-based workflow. Word version ships in June, FrameMaker version ships in July. Sign up for a live, online demo! http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

Previous by Author: RE: Department of redundancy department
Next by Author: RE: A technique to get on development's good side
Previous by Thread: Re: A technique to get on development's good side
Next by Thread: Re: A technique to get on development's good side


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


Sponsored Ads