HSEARCH-5128 More reliably document supported Java versions

Author: yrodiere

Jenkinsfile

@@ -190,6 +190,8 @@ stage('Configure') {
 new JdkBuildEnvironment(version: '23', testCompilerTool: 'OpenJDK 23 Latest',
 testLauncherArgs: '--enable-preview -Dnet.bytebuddy.experimental=true',
 condition: TestCondition.AFTER_MERGE)
+// IMPORTANT: Make sure to update the documentation for any newly supported Java versions
+// See java-version.main.compatible.expected.text in POMs.
 ],
 compiler: [
 new CompilerBuildEnvironment(name: 'eclipse', mavenProfile: 'compiler-eclipse',

documentation/pom.xml

@@ -284,6 +284,7 @@
  <hibernateVersion>${version.org.hibernate.orm}</hibernateVersion>
  <hibernateDocUrl>${documentation.org.hibernate.orm.url}</hibernateDocUrl>
  <hibernateJavadocUrl>${javadoc.org.hibernate.orm.url}</hibernateJavadocUrl>
+ <javaCompatibleVersions>${java-version.main.compatible.expected.text}</javaCompatibleVersions>
  <javaeeUrl>https://www.oracle.com/java/technologies/java-ee-glance.html</javaeeUrl>
  <jakartaUrl>https://jakarta.ee/</jakartaUrl>
  <jakartaPersistenceVersion>${parsed-version.jakarta.persistence.majorVersion}.${parsed-version.jakarta.persistence.minorVersion}</jakartaPersistenceVersion>

documentation/src/main/asciidoc/public/reference/_compatibility.adoc

@@ -9,7 +9,7 @@
 |===============
 | h|Version h|Note
 |Java Runtime
-|8, 11 or 17
+|{javaCompatibleVersions}
 |
 |Hibernate ORM (for the <<mapper-orm,Hibernate ORM mapper>>
 |{hibernateVersion}

pom.xml

@@ -209,6 +209,8 @@
  <java-version.main.release>11</java-version.main.release>
  <java-version.main.compiler.java_home>${java.home}</java-version.main.compiler.java_home>
  <java-version.main.compiler>${java-version.main.compiler.java_home}/bin/javac</java-version.main.compiler>
+ <!-- The versions of Java documented as supported for applications using Hibernate Search -->
+ <java-version.main.compatible.expected.text>11, 17 or 21</java-version.main.compatible.expected.text>
  <!-- The version of test bytecode, useful for testing compatibility with newer JDKs -->
  <!-- Set to the expected version of the JDK running Maven by default, but overridden on CI -->
  <java-version.test.release>${jdk.min.version}</java-version.test.release>