Re: [eclipse-dev] Consistent build notes

["Sonia Dimitrov" <Sonia_Dimitrov@xxxxxxxxxx>]

There is currently a releng bug related
to the build notes:

https://bugs.eclipse.org/bugs/show_bug.cgi?id=34839

Please annotate this bug with any further
suggestions or comments on this issue.

Thanks,

Sonia

Knut Radloff/Raleigh/IBM@IBMUS Sent by: eclipse-dev-admin@xxxxxxxxxxx 06/18/2003 04:27 PM Please respond to eclipse-dev

To:        eclipse-dev@xxxxxxxxxxx         cc:                 Subject:        [eclipse-dev] Consistent build notes

Someone noted in an unrelated bug report that our
build notes are 
formatted quite inconsistently. It was noted, and I have to agree, that
this makes them hard to read.

There are a few different formats used for the header, although the most
common seems to be:
Eclipse Platform Build Notes 
<component>

Then the build id/date is different for most build notes, followed by a
list of bug fixes or a link to a bugzilla report.

I wonder if releng can accept build notes for four common categories and
compile them into a report for each component using a standard template.
This would also allow to compile and categorize the build notes in 
different ways in the future. For example you could provide just those
build notes relevant to the current build instead of cumulative.
The common denominator for the categories seems to be:

What's new in this drop
Other highlights
Known deficiencies
Problem reports fixed

Also, jdt-ui has three different build notes apparently for different 
release levels all linked off individual builds. Let's say there is a 
usability problem with the build notes. Who wants to fix it?

Knut
_______________________________________________
eclipse-dev mailing list
eclipse-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/eclipse-dev