[
https://jira.codehaus.org/browse/MSITE-689?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=329964#comment-329964
]
Herve Boutemy commented on MSITE-689:
-------------------------------------
good ideas: thank you for this list of use cases
any patch appreciated too: prefer multiple little patches to apply fast than
one big that will be hard to work with
> Enhance "configuring reports" documentation
> -------------------------------------------
>
> Key: MSITE-689
> URL: https://jira.codehaus.org/browse/MSITE-689
> Project: Maven Site Plugin
> Issue Type: Improvement
> Components: documentation
> Affects Versions: 3.3
> Reporter: Stephen Colebourne
> Priority: Minor
>
> Since maven 3 changed and then reverted the way that reports should be
> customized, it is very hard to find a complete and accurate example of what
> is now the correct customization of reports and what can be defined where.
> This page,
> http://maven.apache.org/plugins/maven-site-plugin/examples/configuring-reports.html,
> is a start, but needs enhancing.
> 1) If you want to run javadoc/checkstyle/etc in both the main build and the
> site plugin, where should the config be? Build or reporting or both?
> 2) Do the reporting plugins choose aggregating reports automatically if
> running in a reactor, or do they have to be configured? The current example
> suggests extra config is needed.
> 3) If a parent pom defines a reporting block and the same plugin is
> overridden in a child of that parent pom, what happens? What if the child is
> an aggregator?
> 4) Examples, or links, to common reporting plugins (checkstyle/pmd/javadoc)
> are also needed as they all appear to vary subtly.
> Ultimately, it should be possible to go to the page, decide what example
> matches your project structure, and copy/amend from that specific example.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
