Fields of a CSR request

[Doug Lea]

On 04/12/2017 05:14 PM, joe darcy wrote:
> Compatibility-related fields:
>
> Compatibility kind: check boxes for source, binary, and behavioral.
> Check which kinds of compatibility are impacted by this proposal. See
> https://wiki.openjdk.java.net/display/csr/Kinds+of+Compatibility for a
> detailed discussion on the different kinds of compatibility.
>
> Compatibility risk: minimal, low, medium, high
>
> Compatibility risk description: Issues with a compatibility risk of low,
> medium, or high should usually have a release note.

It might be helpful to additionally categorize cases that arise, and the 
considerations that typically apply.

Here's a first shot at some categories (but missing any associated
considerations and criteria):

1. The old spec was unintentionally overly permissive -- it didn't rule 
out some behaviors, or was ambiguously worded or incomplete. 
(Implementations are unchanged.)

2. [Converse to 1] The old spec was overly restrictive, and did not 
allow reasonable/desirable implementation behavior.

3. The old spec contradicted implementation.  The implementation was 
correct/desirable, so need to fix spec.

4. [Converse to 3] The old spec contradicted implementation.  The 
implementation was incorrect/undesirable, but there is user code that 
relies on current implementation, so it is better to change spec.

All four cases are crossed by whether the spec is part of an interface, 
class, or method that could be implemented or overridden externally to JDK.

-Doug