RFR: New text about mailing lists

[Iris Clark]

Hi, Jesper.

David's description of the "-experts", "-observers" and "-comments" lists is correct.  This trio of lists was originally designed as an option for Projects implementing JSRs.  This page contains the descriptions of these lists for the Platform JSRs:

    https://openjdk.java.net/projects/jdk/16/spec/

Thanks,
Iris

-----Original Message-----
From: David Holmes 
Sent: Wednesday, June 10, 2020 9:29 PM
To: Jesper Wilhelmsson <jwilhelm at openjdk.java.net>; guide-dev at openjdk.java.net
Subject: Re: RFR: New text about mailing lists

Hi Jesper,

On 11/06/2020 9:40 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.

The -experts list is not necessarily moderated but it is restricted; only members of the expert group can subscribe to that list. The -observers list is for anyone to subscribe to see what the experts are discussing and potentially to have some dialog with other non-experts. 
There is no guarantee that an expert is subscribed to the observer list or will see any responses on that list. The -comments list is for observers to directly provide feedback/comments to the experts (typically a lead will process the comments list and forward things on to the experts list).

+ speak other languages as their mother tongue.

"mother tongue" is itself a phrase that may cause confusion to non-native English speakers. :) I suggest "native language".

--

      ---
-----------------------------------------------------------------------
!     Y   Submission of a CSR request is required. Work may begin after the
!         request has been [accepted](glossary.html#accepted) by the 
CSR; the
           changeset implementing the fix may be committed to a team forest
!         after the request has been [approved](glossary.html#approved) 
by the CSR.
!         A description of the CSR requirements may be found in
           [Review Bodies](reviewBodies.html).

This text seems quite dated and not fully applicable to the CSR process. 
I would suggest using the same language as used on the CSR wiki. We don't have an "acceptance" phase for CSR requests - work typically begins in parallel with the CSR request, or often before.  "team forest" 
is a generally out-dated term - I would just say "repository".

Thanks,
David
-----

> -------------
> 
> Commit messages:
>   - New text about mailing lists
> 
> Changes: https://git.openjdk.java.net/guide/pull/17/files
>   Webrev: https://webrevs.openjdk.java.net/guide/17/webrev.00
>    Stats: 60 lines in 2 files changed: 49 ins; 7 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
>