Currently, javadoc emits

warning: The code being documented uses packages in the unnamed module, but the packages defined in https://jakarta.ee/specifications/persistence/3.1/apidocs/ are in named modules.

The ability to disable this warning was introduced since JDK 18, see https://bugs.openjdk.org/browse/JDK-8274639 and --link-modularity-mismatch in https://docs.oracle.com/en/java/javase/18/docs/specs/man/javadoc.html#standard-options-for-the-standard-doclet. If we start using JDK 18 or higher, we should disable the warning and enable -Werror and -Xdoclint:all if possible (I failed to find a way of enabling either via Gradle).

I suspect that this warning will be resolved, making this ticket obsolete, if we do HIBERNATE-52.

Addressing the source code notes tagged with TODO-HIBERNATE-129 is in scope of this ticket.