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.
I'd say it was time to learn about programming. There are no shortcuts here. If
you need to document what people are doing, you must *personally comprehend at
a detailed technical level* what they are doing.
You cannot document intelligently from ignorance.
I'd pickup a book on programming in whatever environment/language your people
use and start reading. I'd also find somebody (QA people are good for this) to
walk you through exactly what, why, and how the product/application(s) works.
You should use the product as well and check out the competitors.
Don't interview programmers until you know what you're documenting. You'll
just come off as unprepared and irritating.
----- Original Message -----
>my task at the moment is to create a "work summary" of a just finished
> project (there is virtually no documentation on this project up to this
> point). i will be conducting interviews to discover who did what and why
> they did it. the content of some of the interviews may very well be a little
> over my head (i am going to have to interview some programmers; i don't know
> very much about programming).
> my question is: do any of you have any advice on conducting interviews with
> people/departments that do things you know nothing (or vitrually nothing)
> i am hoping to get to interview the project manager before anyone else; this
> should allow me to have a grasp of the overall project and strategies.
> hopefully this give me an understanding for the programmers and their
> objectives, but i still am incredibly nervous (anxious, stressed,
> intimidated, exhilerated) about having to ask them questions.....
Do You Yahoo!?
Send instant messages & get email alerts with Yahoo! Messenger. http://im.yahoo.com/