The maven-javadoc-plugin version 3.2.0 (in fact 3.1.0 onward) does not build the idp-parent aggregate apidocs like 3.0.1 does. The code base has changed in no insignificant way since 3.0.1.

More specifically, to determine which sub projects to generate the aggregate apidocs for, the plugin matches the maven reactor project paths with the module paths from the `<modules>` section of the idp-parent pom. These are both represented as Java Path objects and for the IdP project structure they do not match (are not `.equal()`) e.g.

Module path:

becomes:

Which does not match the reactor project path of:

To overcome this I rebuilt the 3.2.0 plugin and normalised the aggregated module path (`Path.normalize()`) which eliminates the redundant name elements e.g ‘..' . This then works as expected.

I have logged an issue with the javadoc plugin to see what they have to say (https://issues.apache.org/jira/browse/MJAVADOC-648)