RFR: Added section for newcomers [v8]

Alan Bateman alanb at openjdk.java.net
Thu Dec 3 13:13:03 UTC 2020


On Thu, 3 Dec 2020 11:20:15 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

>> Added a section to the introduction to set the expectations for new developers in the OpenJDK.
>> 
>> I also moved the mail list section up since it's also relevant in this context and should (imho) be the first thing to learn about when thinking about joining the community.
>
> Jesper Wilhelmsson has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Added text about API changes

src/index.md line 35:

> 33: ### 2. Socialize your change
> 34: 
> 35: Once the OCA is signed, please restrain your urge to create a PR just a little while longer. In order to prepare the community for your patch, please socialize your idea on the relevant [mailing lists](#mailing-lists). Almost all changes, and in particular any API changes, must go this route and have a broad agreement in place before there is any point in presenting code. To understand the criteria by which your patch is going to be judged, please read [_Why is My Change Rejected?_](#why-is-my-change-rejected) below. In short, hidden constraints and assumptions, stability and quality, maintainability, compatibility, and conformance to specifications must be considered before your PR is ready to be submitted. If you don't understand the constraints for acceptance, you might be surprised when your PR is rejected.

Thanks for the update. One small suggestion is to say "proposals for new APIs" rather than "any API change".

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

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


More information about the guide-dev mailing list