Overview
The Gradle team has brought it to our attention that we should ideally generate aggregated Javadoc along the lines of the example provided by @jjohannes here.
Rationale
Adopting the aforementioned best practice for aggregating Javadoc across projects will...
- make parallel execution and build configuration caching safer/possible
- avoid potential breakage in future versions of Gradle
- introduce greater separation of concerns
- replace the current, hand-crafted approach with something more robust and maintainable
Comment From: sbrannen
@rwinch, does the use of the io.spring.javadoc-aggregate plugin (#24715) make this issue obsolete?
Comment From: rwinch
Yes