Frequently Asked Questions about the CSR

Q: Can edits be made in the new wiki:
A: Yes, edits can be made in the new wiki.

Q: What is the CSR?
A: The CSR is a review body for changes being made in JDK releases. The letters "CSR" stand for "compatibility and specification review"; therefore the CSR focuses on reviewing specifications (as opposed to implementations) with an emphasis on long-term compatibility impact. Besides compatibly review, review of a specification includes but is not limited to abiding by naming conventions, clear description of semantics, appropriate use of language features, and so on. The compatibility review is not strictly limited to specifications; some implementation-only changes with compatibility impact merit CSR review as well.

Q: How do I create a CSR ?
A: Do not directly create a CSR from the Create Menu. JIRA will let you do this right up until the moment you try to save it and find your typing was in vain.

...

• Changes to public and exported APIs in java.* and javax.* packages.
• Changes to public and exported APIs in jdk.*packages.
• New language updates to the Java Programming Language
• New structures in the Java Virtual Machine Specification
• Adding or removing a command in $JDK/bin
• Adding, removing, or changing a command line option; for details about evolving HotSpot command line options see Hotspot Command-line Flags: Kinds, Lifecycle and the CSR Process
• Using or defining an environment variable
• Using or defining a new file format or wire format
  Changing or defining a new system or security property; be by default, as of JDK 12 system properties should be documented using the @systemProperty javadoc tag.

...