Currently, javadoc emits

warning: The code being documented uses modules but the packages defined in https://javadoc.io/doc/org.jspecify/jspecify/1.0.0/ are in the unnamed module.

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.

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