RE: Do I have to understand the material?

Subject: RE: Do I have to understand the material?
From: "Jane Carnall" <jane -dot- carnall -at- digitalbridges -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 16 Aug 2002 18:19:27 +0100

Paul Strasser wrote:
<So I guess I was writing a user's guide to Interpreting Grand Geyser for
<Visitors. And you needed both a writer and SME - and I wore both hats.

And, unusually, you were THE SME - the only one, and one who could write.
I'm sure you delivered a cracker of a manual.

But - let's say that the necessary information on all the geysers was not
contained within the head of one SME who was also a writer. Suppose there
were four or five SMEs with overlapping information, and that none of them
could write coherently? A better manual might then be produced by hiring a
writer with some background (so that they wouldn't waste the SMEs time on
the really silly questions) but with the capacity to gather the information
and put it together, thus making connections these (hypothetical) five SMEs
might not even be aware of. This writer might not, at the start of the
project, know as much about geysers as any one of the SMEs - but a skilled
technical writer would still be able to put together an excellent manual,
though it would likely take somewhat longer than in the fortunate situation
where a skilled technical writer was ALSO the best SME.

Jane Carnall
"This is a lighthouse. Your call."
Apologies for the long additional sig: it is added automatically and outwith
my control. Home: hj -dot- carnall -at- virgin -dot- net


E-mail is an informal method of communication and may be subject to data corruption, interception and unauthorised amendment for which Digital Bridges Ltd will accept no liability. Therefore, it will normally be inappropriate to rely on information contained on e-mail without obtaining written confirmation.

This e-mail may contain confidential and/or privileged information. If you are not the intended recipient (or have received this e-mail in error) please notify the sender immediately and destroy this e-mail. Any unauthorized copying, disclosure or distribution of the material in this e-mail is strictly forbidden.


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!

TECHWR-L is supported by ads and sponsorships...and donations.
You can help maintain the TECHWR-L community with donations

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 for more resources and info.

Re: Do I have to understand the material?: From: Paul Strasser

Previous by Author: RE: "cleaning" a Word style?
Next by Author: RE: Personal POV
Previous by Thread: Re: Do I have to understand the material?
Next by Thread: RE: "cleaning" a Word style?

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

Sponsored Ads