chore: test on java 17 (#115)

* chore: test on java 17

* Fix javadoc issue

Author: slide

Jenkinsfile

@@ -1,9 +1,16 @@
 def configurations = [
-    [ platform: "linux", jdk: "8", jenkins: null ],
-    [ platform: "windows", jdk: "8", jenkins: null ],
-    [ platform: "linux", jdk: "11", jenkins: null ],
+  // Test the long-term support end of the compatibility spectrum (i.e., the minimum required
+  // Jenkins version).
+  [ platform: 'linux', jdk: '8', jenkins: null ],
+
+  // Test the common case (i.e., a recent LTS release) on both Linux and Windows.
+  [ platform: 'linux', jdk: '11', jenkins: '2.332.1' ],
+  [ platform: 'windows', jdk: '11', jenkins: '2.332.1' ],
+
+  // Test the bleeding edge of the compatibility spectrum (i.e., the latest supported Java runtime).
+  [ platform: 'linux', jdk: '17', jenkins: '2.342' ],
 ]
 
 buildPlugin(
     configurations: configurations
-)
+)

pom.xml

@@ -12,7 +12,6 @@
     <changelist>999999-SNAPSHOT</changelist>
     <gitHubRepo>jenkinsci/${project.artifactId}-plugin</gitHubRepo>
     <jenkins.version>2.289.1</jenkins.version>
-    <java.level>8</java.level>
   </properties>
 
   <licenses>

src/main/java/org/jenkinsci/plugins/tokenmacro/TokenMacro.java

@@ -99,9 +99,6 @@ public abstract class TokenMacro implements ExtensionPoint {
     /**
      * Evaluates the macro and produces the token.
      *
-     *
-     * <h3>Locale</h3>
-     * <p>
      * If the token is to produce a human readable text, it should do so by using the implicit locale associated
      * with the calling thread &mdash; see {@code Functions.getCurrentLocale()}.
      *