[
https://issues.apache.org/jira/browse/MNG-6189?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16204568#comment-16204568
]
Hervé Boutemy edited comment on MNG-6189 at 10/14/17 2:50 PM:
--------------------------------------------------------------
thank you for this useful feedback: yes, we need to improve the experience when
someone tries to understand what to do when he gets this message
I'll need your help to find the best place to explain things, then link
directly from StackOverflow, because I did all the changes, and I'm struggling
to create simple and concise explanations...
the full reference explanations are in Maven Site Plugin Configuration Formats
section:
http://maven.apache.org/plugins/maven-site-plugin/maven-3.html#Configuration_formats
do you think it's sufficiently clear? do you have ideas on how to improve it?
And should we add something specific to the WARN message that was added in
Maven 3.5.0?
was (Author: hboutemy):
thenk you for this useful feedback: yes, we need to improve the experience when
someone tries to understand what to do when he gets this message
I'll need your help to find the best place to explain things, then link
directly from StackOverflow, because I did all the changes, and I'm struggling
to create simple and concise explanations...
the full reference explanations are in Maven Site Plugin Configuration Formats
section:
http://maven.apache.org/plugins/maven-site-plugin/maven-3.html#Configuration_formats
do you think it's sufficiently clear? do you have ideas on how to improve it?
And should we add something specific to the WARN message that was added in
Maven 3.5.0?
> WARN if maven-site-plugin configuration contains reportPlugins element
> ----------------------------------------------------------------------
>
> Key: MNG-6189
> URL: https://issues.apache.org/jira/browse/MNG-6189
> Project: Maven
> Issue Type: Improvement
> Components: Inheritance and Interpolation, Sites & Reporting
> Affects Versions: 3.5.0-alpha-1
> Reporter: Hervé Boutemy
> Assignee: Hervé Boutemy
> Fix For: 3.5.0-beta-1, 3.5.0
>
>
> with MNG-4162, a bunch of reporting logic was removed from Maven core.
> This was globally successful, but not on one topic: it was expected to remove
> pom's {{reporting}} section and replace it with a normal {{reportPlugins}}
> parameter in maven-site-plugin configuration.
> We later discovered that with this normal parameter, we missed one crucial
> feature: report plugins inheritance, which would require a new mechanism
> MSITE-484
> Then we reverted our instructions in maven-site-plugin documentation
> MSITE-647: the new {{reportPlugins}} parameter is now just an implementation
> detail, but should not be used by end-users, {{reporting}} section remains
> the way to configure report plugins MSITE-684
> Now adding a warning in Maven core when it detects a {{reportPlugins}}
> parameter in a maven-site-plugin configuration is easy to do, will help users
> come back to normal {{reporting}} configuration, and will permit future
> enhancements (we need to finally completely clean-up the situation we created
> with this story...)
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
