P2
The following inputs from Alex Buckley need to be addressed:
1.
Stepping back, Chapter 7 is exhausting to read because every section presents the 8-9-10-11-12+ changes slightly differently. A reader on JDK
11 has to work hard to figure out that "Oh, this section doesn't apply to me because it's discussing changes that already happened in 8->9 and
9->10." No acknowledgement is made that 8->11, 11->17, and 8->17 are the common upgrade paths -- no call-outs exist to give focused advice:
"8->17 users: Be aware that ..."
2.
Improve --add-opens over --add-exports -- topics
3.
Improve Behavior Change in Regular Expression Matching topic
4.
All JDK 9 through 17 CSRs that are medium to high compatibility risk:
https://bugs.openjdk.java.net/issues/?jql=project%3Djdk%20and%20type%3Dcsr%20and%20fixversion!%3Dempty%20and%20fixversion%20in%20regexversion(%229.*%22%2C%221%5B0-7%5D.*%22)%20and%20%22Compatibility%20Risk%22%20in%20(high%2C%20medium)%20and%20summary!~incubator%20and%20key!%3DJDK-8214458
1.
Stepping back, Chapter 7 is exhausting to read because every section presents the 8-9-10-11-12+ changes slightly differently. A reader on JDK
11 has to work hard to figure out that "Oh, this section doesn't apply to me because it's discussing changes that already happened in 8->9 and
9->10." No acknowledgement is made that 8->11, 11->17, and 8->17 are the common upgrade paths -- no call-outs exist to give focused advice:
"8->17 users: Be aware that ..."
2.
Improve --add-opens over --add-exports -- topics
3.
Improve Behavior Change in Regular Expression Matching topic
4.
All JDK 9 through 17 CSRs that are medium to high compatibility risk:
https://bugs.openjdk.java.net/issues/?jql=project%3Djdk%20and%20type%3Dcsr%20and%20fixversion!%3Dempty%20and%20fixversion%20in%20regexversion(%229.*%22%2C%221%5B0-7%5D.*%22)%20and%20%22Compatibility%20Risk%22%20in%20(high%2C%20medium)%20and%20summary!~incubator%20and%20key!%3DJDK-8214458