[Rev 01] RFR: New text about mailing lists

[David Holmes]

Hi Jesper,

A couple of follow up comments.

On 12/06/2020 7:20 am, Jesper Wilhelmsson wrote:
>> The last three types of lists, used for expert groups, could use a better explanation. I'm not sure how these types of
>> lists are used though.
> 
> Jesper Wilhelmsson has updated the pull request incrementally with one additional commit since the last revision:
> 
>    Updates after review
> 
> -------------
> 
> Changes:
>    - all: https://git.openjdk.java.net/guide/pull/17/files
>    - new: https://git.openjdk.java.net/guide/pull/17/files/311fdc5b..96173f56
> 
> Webrevs:
>   - full: https://webrevs.openjdk.java.net/guide/17/webrev.01
>   - incr: https://webrevs.openjdk.java.net/guide/17/webrev.00-01

8 All participation in an OpenJDK project starts with joining the 
project mailing
9 list. All OpenJDK mailing lists are found here:

I would say "joining the relevant mailing lists" as not all lists are 
obviously project related - see next point.

24 There are a few different types of lists. The list name has two parts 
to explain what
25 the list is intended for, `<project>-<suffix>`, where the first part 
is the project
26 that owns the list and the second part is explained below.

That is a description of the high-level mailing lists typically created 
for project discussion, but not all mailing lists are like that. We have 
hotspot-dev, hotspot-runtime-dev, hotspot-gc-dev etc etc which do not 
fall into this categorisation. They relate to development primarily in 
the JDK project (but that isn't evident in their name), but they can be 
used in relation to numerous projects.

And not all projects have the full set of lists described (e.g. no 
experts/observers/comments for JDK project or JDK Updates project etc.)

Cheers,
David
-----

>    Stats: 12 lines in 1 file changed: 5 ins; 3 del; 4 mod
>    Patch: https://git.openjdk.java.net/guide/pull/17.diff
>    Fetch: git fetch https://git.openjdk.java.net/guide pull/17/head:pull/17
> 
> PR: https://git.openjdk.java.net/guide/pull/17
>