RFR: Added section for newcomers [v8]

[Jesper Wilhelmsson]

On Thu, 3 Dec 2020 14:02:51 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> That seems like it narrows down the criteria. Maybe Random J Hacker only wants to add a getFronglified() to java.lang.String -- since that is not a new API, he does not think it necessary to discuss it first..?
>> 
>> I'd say keep it as it is; it's better to send one too many to the mailing list rather than one too few.
>> 
>> And also, it's better to actually get this document out to the public. We can refine it iteratively if we discover that people misunderstand it.
>
> String::getFronglified would be a new API, best to get agreement on the mailing list before proposing a patch. It's very possible that the API has been discussed and rejected many times or it has interactions with many other areas of the platform. To some extent we have a bit of a cultural clash here in that many developers are used to "code first" and use the PR to start the discussion. For new standard or JDK-specific APIs, this might be the first 1% of the work.

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?

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

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