RE: Being Resourceful

Subject: RE: Being Resourceful
From: Shelly_Butcher <ShellyB -at- orsus -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 25 Jun 2001 12:16:29 +0200

Great article.
I would add a small point: learn how to listen to each developer you
interview.

While some developers may expound at great length on their subject of
expertise, others may explain things very briefly. Sometimes those who talk
the most get into unncessary details, whereas those who speak less may leave
out important details. As a technical writer, it's important to know enough
about the subject before interviewing the developer, so that you can ask the
right questions. Yet you also need some distance from the subject matter, so
that you can differentiate between the details that more and less important
to document. By analyzing and adapting to each developer's "teaching style",
you can learn what sorts of questions to ask, and how to ask them.

For example, there's one particular developer I used to interview alot, who
can go into incredibly complex and technical detail about, well, just about
anything. While he's very interesting to talk to, sometimes it's a bit much
(e.g., Q: "What time is it?" A:"To make a watch..."). I find that it's
usually best to ask him very specific questions after doing extensive
research on my own.

Shelly

Shelly Butcher - Technical Writer
Orsus Solutions www.orsus.com
mailto:shelly -at- orsus -dot- com
Ph 972-3-5386721, F 972-3-5386700
----------------------------------------------------------------------------
---
"Nearly any invented quotation, played with confidence,
stands a good chance to deceive." - Mark Twain

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

*** 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

Sponsored by Cub Lea, specialist in low-cost outsourced development
and documentation. Overload and time-sensitive jobs at exceptional
rates. Unique free gifts for all visitors to http://www.cublea.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: Is the job market really *that* bad? (long)
Next by Author: XML book
Previous by Thread: Re: Being Resourceful
Next by Thread: Re: Being Resourceful


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


Sponsored Ads