RFR: Added section for newcomers [v8]

Alan Bateman alanb at openjdk.java.net
Thu Dec 3 17:10:01 UTC 2020


On Thu, 3 Dec 2020 17:06:16 GMT, Stuart Marks <smarks at openjdk.org> wrote:

>> I tend to agree with Magnus here. Don't we want to cover changes that removes a part of the API or just changes the behavior of some method?
>
> I think "any API change" is preferable to "new API" -- I could easily imagine somebody coming along and saying, "All I want to do is to have this method return null instead of throwing NPE. That's not a new API." There's a larger discussion to be had somewhere else about what constitutes an API change, in particular that some behavior changes *are* API changes. Meanwhile "any API change" is probably sufficiently inclusive for now.

Okay but Magnus's example is a new API.

-------------

PR: https://git.openjdk.java.net/guide/pull/38


More information about the guide-dev mailing list