in reply to Re: Functional and Unit Test Redundancy
in thread Functional and Unit Test Redundancy

Could you give an example of what you would consider good "release notes" or good use of "release notes"?
  • Comment on Re: Re: Functional and Unit Test Redundancy

Replies are listed 'Best First'.
Re: Re: Re: Functional and Unit Test Redundancy
by bfilipow (Monk) on May 09, 2004 at 10:46 UTC

    IMO, "release notes" are the part of documentaions which lists known bugs/issues of the product. All the minor and not-so-minor flaws which there were no resources to fix in that version, but should be fixed in next releases. "RN" should be the summary, with details included in more appropriate part. The lack of unit test to any module should be mentioned here.

    In your case, the part of the documentation that describes tests shuold have a discussion of what the functional tests could not cover and why.

    There is one more problem you should bear in mind turning down unit tests - any reuse of any part of your code is questionable. It could be easier to write it from scratch than to use yours.

    Mind that it is my private opinion of what good "release notes" are.