Re: Re(2): I'm taking my marbles and going home...

Subject: Re: Re(2): I'm taking my marbles and going home...
From: "Martin R. Soderstrom" <scribbler1382 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 13 Aug 2002 13:32:32 -0400


> Depending on what you mean with "expert", I might disagree. If you mean
> that the writer does not need to be on a similar level of expertise as
> the SMEs themselves, you're probably right for most cases. If you mean
> that just neing a technical writer means you can document almost
> everything, I think you'd be wrong.

expert, sme, knowledgeable elder, fat guy with a memory...call it whatever
you want, it's the person with the information you need.

And when I talk about "technical writers" I'm not referring to the
one-trick-ponies. I'm sure some of them are very, very good OTP's and do a
great job, but they're not whom I'm referring to. I'm talking about
writers; people with an ability to explain and educate tailored to their
audience, people with a sponge for a brain and an insatiable curiousity
about everything; people who...hey, who's playing that music? :)

> Same with programming manuals: If you want to write a manual for a
> programming language or a fundamental programming tool or non-trivial
> API, you need to be a programmer; there's just no way around it if you
> want to create a decent manual.

That's nonsense. What you need is an understanding of how programmer's
=think=. Sure, you're going to need some basic understanding of
technologies and practices, but no where near the depth to which an actual
programmer would. In fact, that can be a hindrance.

Ever watch the face of a kid just out of school being taught by a guy with
15 years experience how to do something? Objectivity has its value.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Want to support TECHWR-L? Get shirts, bags, hats, clocks,
and more from the TECHWR-L Store. All proceeds support TECHWR-L.
http://www.cafepress.com/cp/store/store.aspx?storeid=techwhirl

Save up to 50% with RoboHelp Deluxe. Get 2 great products for 1 low price!
You'll get RoboHelp Office PLUS RoboDemo, the software demonstration tool
that everyone's been talking about. Check it out and save!
http://www.ehelp.com/techwr-l

---
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: I'm taking my marbles and going home...
Next by Author: Re: Re(2): I'm taking my marbles and going home...
Previous by Thread: Re(2): I'm taking my marbles and going home...
Next by Thread: RE: Re(2): I'm taking my marbles and going home...


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


Sponsored Ads