[jira] [Created] (KAFKA-13895) Fix javadocs build with JDK < 12

["Tom Bentley (Jira)" <ji...@apache.org>]

Tom Bentley created KAFKA-13895:
-----------------------------------

             Summary: Fix javadocs build with JDK < 12
                 Key: KAFKA-13895
                 URL: https://issues.apache.org/jira/browse/KAFKA-13895
             Project: Kafka
          Issue Type: Task
          Components: docs
            Reporter: Tom Bentley


While doing the "Website update process" in the 3.1.1 release I found that I'd broken the javadoc search functionality due to having build the Java docs with Java 11. Java < 12 [a bug|https://bugs.openjdk.java.net/browse/JDK-8215291] that means the javadoc search functionality adds /undefined/ in the URL path (even though links between pages otherwise work. 

We could fix the build.gradle to use {{-no-module-directories}} when running with javadoc < v12, but that will then break the links to the JDK classes javadocs from the Kafka javadoc, [as described here|https://github.com/spring-projects/spring-security/issues/10944].

Alternatively we could change the release process docs to require building with Java 17. While this would fix the problem for the Javadocs published on the website, anyone building the javadocs for themselves would still be affected.




--
This message was sent by Atlassian Jira
(v8.20.7#820007)