Migrate javadoc links into individual projects
Description
Environment
Activity
Scott CantorOctober 10, 2023 at 3:11 PM
Plugins on the old branch should have working javadoc for the most part. If anything else is missing it will flush out when/if we convert the site jobs over.
Scott CantorOctober 6, 2023 at 6:36 PMEdited
Still working on this for the branch. For expedience-sake, the plugins (which tend to reference older IdP versions) will be hard-wired for now to reference the published docs, which are fixed versions. This is somewhat like the original workaround we used in the old parent, except that it’s specific to each project and easier to realize needs to be adjusted.
It’s unlikely the old plugins will see a lot of subsequent releases, and even if thet do they likely won’t actually be moved to a later IdP version, so these workarounds are probably permanent until we sunset the branch.

Philip SmartSeptember 25, 2023 at 4:00 PMEdited
Yeah, only the release profile activates the Javadoc plugin. Well, unless you activate explicitly on the command line of course.
Scott CantorSeptember 25, 2023 at 3:58 PMEdited
As “expected?”, I guess the main compile/install goals do not build the individual or aggregated docs. It’s the release profile that turns that on. So, if we want to change to the aggregated jar, I think we just have to change the release profile’s config to use that goal instead of jar and test-jar. OTOH, I suspect perhaps that Eclipse might actually want those individual jars to be available to expose them as tool tips, particularly for released versions. Probably will need to play with that.
Scott CantorSeptember 21, 2023 at 7:28 PM
Commit 626939c to java-idp-plugin-totp
Repurposing this issue, we agreed on a call that we want to rework all of the javadoc production and confiiguration:
Require each project’s parent to individually declare all of the desired “linked” javadocs for its javadoc build
Once working, remove the links from the parent POM
Eventually remove the site configuration and builds from the parent and all projects