It's a bit extreme, but we're starting from a clean slate, so now is a
good time to make that kind of change, to ensure the javadoc will stay
clean in the future.
Current status: on hold. I tried to enable the option, but there's a bug in the maven-javadoc-plugin that prevents us from using it on CI: https://issues.apache.org/jira/browse/MJAVADOC-538
Branch with the work in progress: https://github.com/yrodiere/hibernate-search/tree/HSEARCH-3375
Looks like this was fixed in maven-javadoc-plugin 3.1.0. I'll try again soon.