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.
Subject:Re: Interviewing/getting info from SMEs From:Glenda Jeffrey <jeffrey -at- HKS -dot- COM> Date:Wed, 23 Aug 1995 12:14:36 GMT
Patty Ewy (pewy -at- sun1 -dot- anza -dot- com) wrote:
: One of the things that has really been a challenge is getting a system that
: makes sure that we get all the information we need from the development
: staff....
: How do you do this?
Here's an idea I intend to try:
1. Get an understanding of how the code is modularized.
2. Write a little program which goes out every night
(or every week, or whatever) and finds out what parts (modules) of the
code changed, and who changed them. This should be do-able
if your company is using any sort of automated source code control system
to track code changes. Since you've already done step 1, you'll
be able to sort out changes that affect the documentation (e.g.
GUI changes) from changes that don't (e.g. infrastructure changes).
3. The next morning, take your list and track down the programmers
responsible for the changes. Interrogate them (using bright lights
and hot candle wax if necessary) until they tell you what the
changes were.
My guess is that, after a few go-rounds with each programmer, they'll
have the bright idea that it would have been easier to tell you
what the changes were before they implemented them.
Has anybody tried this sort of technique?
--
Glenda Jeffrey Email: jeffrey -at- hks -dot- com
Hibbitt, Karlsson & Sorensen, Inc Phone: 401-727-4200
1080 Main St. Fax: 401-727-4208
Pawtucket, RI 02860