RE: What then is the SME/TW functional relationship?

Subject: RE: What then is the SME/TW functional relationship?
From: "Marguerite Krupp" <mkrupp -at- cisco -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 28 Feb 2002 10:28:16 -0500

Because I work in software, the stuff I write about is often only
thinly-defined and partially implemented when I begin writing about it. I
get a copy of the software or a profile on the system running the software
while it's still in development. I try to do things with it. I crash the
system, just like the engineers do<G>. I try to figure things out, based on
my experience with other systems and on my reading of whatever I can get my
eyeballs on that appears relevant. I talk to and listen to a lot of
engineers, especially those in QA. We use whiteboards a lot. I constantly
refine the docs, just as the engineers/implementors refine the software.

Because the software is changing as I write about it, I must rely on SMEs to
verify that the docs I write accurately reflect the state of the product at
the time we ship Beta and final products. This doesn't mean that I don't
know the product. Rather, it's a way of making sure that we catch, or at
least minimize, any discrepancies between what I've written and what they
understand about the product.

The engineers I'm working with are great! They review quickly, communicate
well, and they're very focused. I suspect that this is an artifact of the
development process in which writers participate as part of the team. If I
were to wait until the product is "frozen" before starting the docs, the
process wouldn't work nearly so well.

Just my $0.02,
Marguerite


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Now's a great time to buy RoboHelp! You'll get SnagIt screen capture
software and a $200 onsite training voucher FREE when you buy RoboHelp
Office or RoboHelp Enterprise. Hurry, this offer expires February 28, 2002. www.ehelp.com/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

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


References:
What then is the SME/TW functional relationship?: From: Hart, Geoff

Previous by Author: RE: Netscape 6x
Next by Author: RE: parenthood and tech writing
Previous by Thread: What then is the SME/TW functional relationship?
Next by Thread: RE: RE: What then is the SME/TW functional relationship?


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


Sponsored Ads