[
https://issues.apache.org/jira/browse/ACCUMULO-1487?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
John Vines updated ACCUMULO-1487:
---------------------------------
Labels: Documentation (was: )
> Package javadocs for monitor better, or not at all
> --------------------------------------------------
>
> Key: ACCUMULO-1487
> URL: https://issues.apache.org/jira/browse/ACCUMULO-1487
> Project: Accumulo
> Issue Type: Improvement
> Components: docs
> Reporter: Christopher Tubbs
> Labels: Documentation
> Fix For: 1.6.0
>
>
> Packaging javadocs are problematic for the monitor page because we need to do
> something like:
> {code}mvn clean compile javadoc:aggregate package{code}
> so the classes are compiled prior to building the javadocs (for some reason,
> this is a requirement), and the javadocs are available to be packaged when
> the monitor is packaged. However, this essentially duplicates the build
> lifecycle between the initialize and compile phase.
> Options:
> # Use maven-invoker-plugin to execute the "mvn compile javadoc:aggregate"
> separately, with minimal plugins configured (not sure the effect this will
> have on maven-release-plugin which also executes maven-invoker-plugin).
> # Make monitor depend on javadoc artifacts from other modules, and serve them
> (repackaging, if necessary). This might require javadoc artifacts to be built
> whenever the monitor is built, and not just during a release.
> # My preferred option: don't package javadocs with the monitor. Instead, link
> to the Accumulo website (with a configurable base address, to support
> environments where javadocs are mirrored, in case they can't directly access
> the Apache website).
--
This message was sent by Atlassian JIRA
(v6.1#6144)
