RFR: Added section for newcomers [v2]

Jesper Wilhelmsson jwilhelm at openjdk.java.net
Wed Nov 18 22:25:23 UTC 2020


On Wed, 18 Nov 2020 21:55:14 GMT, Magnus Ihse Bursie <ihse at openjdk.org> wrote:

>> Hm yes, that did turn into a wall of text, didn't it? :-) Maybe for the paragraph itself, just pull off the bullet headers and list them as reasons, without further elaboration here. So the second part of the paragraph might read something like,
>> 
>>> Even though many ideas are indeed good, we must be quite restrictive on what we actually include into the JDK. There are many reasons for this, including: hidden constraints and assumptions, stability and quality, maintainability, compatibility, and conformance to specifications.
>> 
>> No need to list every one of the bullet items; the above is probably enough.
>> 
>> We can discuss the need for a "Why is it so hard to contribute to OpenJDK?" section separately. I suspect we'll need something like that sooner or later. Meanwhile, the text I wrote will be here and we can from copy it later.
>
> �� 
> 
> I like your suggestion. And yes, we can save the elaboration for a later date.

I copied from both your suggestions and added a section "Why is my change rejected?" as part of the introduction.

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

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


More information about the guide-dev mailing list