Bar for release notes

Joseph D. Darcy joe.darcy at oracle.com
Tue Jul 11 04:41:12 UTC 2023


Hello,

On 7/3/2023 1:15 AM, David Holmes wrote:
> On 3/07/2023 5:55 pm, - wrote:
>> Hi CSR group,
>> Just curious, what is usually the condition for the requirement of a 
>> release note for CSR changes? Is it usually related to behavior 
>> changes to frequently-used APIs, and how large would a change be to 
>> require such a note?
>
> There are no hard and fast rules here, it is very subjective and often 
> happens because the CSR review process raises a request to add a 
> Release Note.
>
> To me it is mainly a matter of how noticeable any change in behaviour, 
> or change in API would be. Consider the number of changes in any given 
> release of OpenJDk compared to the number of release notes - not many 
> changes get release notes. That said a change doesn't have to be large 
> to warrant a release note, it just has to be quite noticeable to 
> anyone using the affected bit of code.
>
A few rough statistics for context: there are about 2,400 bug 
fixes/enhancements in a JDK feature release and about 150 CSRs.

The items which get release notes may or may not have a corresponding 
CSR and, as David notes, one of the outcomes of CSR review is "please 
write a release note."

Subjectively, if a change could be sufficiently surprising to users and 
isn't otherwise documented (as with a JEP, etc.), then the change should 
have a release note.

HTH,

-Joe



More information about the csr-discuss mailing list