RE: where do docs fit in the development process?

["Jane Carnall" <jane -dot- carnall -at- digitalbridges -dot- com>]

Christensen, Kent wrote:
>>If your firm won't do documentation testing, here is the story:
>>Your developers very likely expect you to understand your firm's products
>>and to be able to write an accurate manual.  They do not necessarily
>>perceive it their job to validate the documentation--in the long run your
>>tech support department will provide that service by providing you
>>frequently asked questions.  Your job, outside and in addition to
producing
>>documentation, is to learn how your products work and to test your
>>documentation yourself.

And presumably the developers in this scenario expect to write accurate code
first time and never do peer reviews. If bugs are introduced into the code
and no one spots them, the tech support department will provide that service
by passing on bug reports from customers.

Jane Carnall
The writers all stand around a cauldron chanting and occasionally tossing in
a small rodent. Apologies for the long additional sig: it is added
automatically and outwith my control.


________________________________________________________________________

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.

________________________________________________________________________


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you 
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of 
your book. What are you waiting for? http://www.iuniverse.com/media/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.