joshelser commented on a change in pull request #1844: URL: https://github.com/apache/hbase/pull/1844#discussion_r435309158
########## File path: src/main/asciidoc/_chapters/configuration.adoc ########## @@ -97,55 +97,76 @@ This section lists required services and some required system configuration. [[java]] .Java -The following table summarizes the recommendation of the HBase community wrt deploying on various -Java versions. A icon:check-circle[role="green"] symbol is meant to indicate a base level of +The following table summarizes the recommendations of the HBase community with respect to deploying +on various Java versions. The icon:check-circle[role="green"] symbol indicates a base level of testing and willingness to help diagnose and address issues you might run into. Similarly, an entry -of icon:exclamation-circle[role="yellow"] or icon:times-circle[role="red"] generally means that -should you run into an issue the community is likely to ask you to change the Java environment -before proceeding to help. In some cases, specific guidance on limitations (e.g. whether compiling -/ unit tests work, specific operational issues, etc) will also be noted. +of icon:exclamation-circle[role="yellow"] means that, should you run into an issue, the community +is likely to ask you to change the Java environment rather than proceeding to help on that Java +version. This applies categorically to Non-LTS releases (see below). The +icon:times-circle[role="red"] means that support has been dropped for this version or has been +attempted and is known to not work. For combinations of newer JDK with older HBase releases, it's +likely that there are known compatibility issues that cannot be addressed under our compatibility +guarantees, making that combination impossible. In some cases, specific guidance on limitations +(e.g. whether compiling / unit tests work, specific operational issues, etc) will also be noted. + +.Long-Term Support JDKs are Recommended +[WARNING] +==== +HBase recommends downstream users rely on JDK releases that are marked as Long-Term Supported +(LTS), either from the OpenJDK project or vendors. At the time of this writing, the following JDK +releases are NOT LTS releases and are NOT supported by the Apache HBase community: JDK9, JDK10, Review comment: Maybe, make the previous paragraph.. > blah blah blah long-winded, or "untested" And then just use that "untested" here? Maybe we can define exactly what we mean once and just use that again. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org