CSR FAQ Additions

[Adam Farley8]

Hi David,

Thanks for the feedback. :)

If Item 1 is useful, but more general than CSR, should the step-by-step be 
paired with a summary of the term, and dropped into one of the 
general-purpose Glossaries?

E.g. https://openjdk.java.net/guide/glossary.html

As for item 2, you're right. We don't need my extra bit in the FAQ.

Best Regards

Adam Farley 
IBM Runtimes


David Holmes <david.holmes at oracle.com> wrote on 01/04/2019 03:55:31:

> From: David Holmes <david.holmes at oracle.com>
> To: Adam Farley8 <adam.farley at uk.ibm.com>, csr-discuss at openjdk.java.net
> Cc: web-discuss at openjdk.java.net
> Date: 01/04/2019 03:55
> Subject: Re: CSR FAQ Additions
> 
> Hi Adam,
> 
> Moving this to the csr-discuss mailing list.
> 
> Item 1 is useful info but not specific to the CSR process. In fact 
> "Release Notes" are not AFAIK actually defined by the OpenJDK project, 
> but rather are a distribution specific artefact. (Which is something 
> that should probably be corrected!)
> 
> Item 2 may already be addressed by some very recent additions Joe made 
> to the wiki regarding workflow diagrams:
> 
> https://urldefense.proofpoint.com/v2/url?
> u=https-3A__wiki.openjdk.java.net_display_csr_Main&d=DwID-
> g&c=jf_iaSHvJObTbx-siA1ZOg&r=P5m8KWUXJf-
> CeVJc0hDGD9AQ2LkcXDC0PMV9ntVw5Ho&m=9x12-
> 
mwe8DO90busY9uriQjnLcKDJQVdS7YV_zO4F8s&s=fnCNUiNdi7k__FRS7Bc6NNRuxBU9Txg5smNGbNyB-
> Rw&e=
> 
> Cheers,
> David
> 
> On 29/03/2019 9:51 pm, Adam Farley8 wrote:
> > Hi All,
> > 
> > The CSR FAQ [1] is a great resource that answers a lot of important 
> > questions.
> > 
> > On reading it, and going through a CSR myself, I've identified two 
> > points that
> > should be added to the FAQ (assuming they aren't detailed elsewhere, 
and 
> > I've
> > just missed them).
> > 
> > Here's a draft for the two additions.
> > 
> > ----- Addition 1: underneath "Q: What are common types of feedback for 

> > the CSR to give?" -----
> > Q: How do I create a release note?
> > A: By following this process:
> >     1) Find the parent bug for the CSR, and add the label 
> > "release-note=yes".
> >     2) Create a sub-task via the menu "More -> Create sub-task".
> >     3) Use "Release note: " as the title, followed by a few words on 
the 
> > nature of the change.
> >     4) Fill in the rest of the sub-task with brief details on the 
parent 
> > bug's changeset, and include the label "release-note"
> >     5) Finally, seek review for the release note before closing it.
> > 
> > ----- Addition 2 -----
> > Q: How do I progress a CSR?
> > A: By gathering reviews and moving it through the states until you 
reach 
> > "finalized" state.
> >     Finalized CSRs are automatically reviewed by the CSR board, and 
they 
> > will move it through
> >     to "closed" state once an appropriate resolution has been chosen. 
Be 
> > sure your CSR is
> >     polished and ready for final assessment before moving it into 
> > finalized state.
> > 
> > ----- End of Additions -----
> > 
> > Please review and comment, thanks. :)
> > 
> > Best Regards
> > 
> > Adam Farley
> > IBM Runtimes
> > 
> > [1] https://urldefense.proofpoint.com/v2/url?
> u=https-3A__wiki.openjdk.java.net_display_csr_CSR-2BFAQs&d=DwID-
> g&c=jf_iaSHvJObTbx-siA1ZOg&r=P5m8KWUXJf-
> CeVJc0hDGD9AQ2LkcXDC0PMV9ntVw5Ho&m=9x12-
> 
mwe8DO90busY9uriQjnLcKDJQVdS7YV_zO4F8s&s=Rn4CmbpbLRSPgbv7pvMVP5yHTuqTDZBlYgYHgOGtisg&e=
> > Unless stated otherwise above:
> > IBM United Kingdom Limited - Registered in England and Wales with 
number 
> > 741598.
> > Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 
3AU
> 

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU