RE: Summary: True insignificance... and release notes

Subject: RE: Summary: True insignificance... and release notes
From: "Cadorette Johanne" <johanne -dot- cadorette -at- locusdialog -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 8 Mar 2002 09:53:00 -0500

Thanks to everyone who answered my post about release notes.

Seems we are not alone in having difficulty with release notes! The most efficient practice seems to be using an automated or at least established process for extracting the bug info from the tracking software, which a developer or TW can do.

There is also a distinction between problems reported by customers, and bugs from builds. I think this may be the root of our troubles. The bugs reported by our customers are not logged into our bug tracking software. We (doc dept) rely on developers to provide that information, and they often don't have the time to do it when we need it. And while we have access to the system that tracks our build bugs, it seems little attention is paid to categorizing the bugs beyond "open" and "fixed." We then need someone from QA to tell us which bugs need to go in the release notes. This could easily be solved by simply implementing a flagging system, or different degrees of severity.

Distribution seems to be a hot button issue, too. It seems that whom the release notes are for and how these people will get them is often unclear (when there is no intranet and CD distribition is not possible).

Anyway, lots of food for thought here. Thanks again!

Johanne Cadorette

Check it out! Get some cool freebies when you buy RoboHelp! You'll receive
SnagIt screen capture software and a 10% discount voucher for RoboHelp
Consulting. This special offers expires March 29, 2002.
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.

Previous by Author: True insignificance... and release notes
Next by Author: RE: ranges in index entries
Previous by Thread: How much experience for API writing?
Next by Thread: RE: Tech Writing: The Second Generation (OT?)

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

Sponsored Ads