[ 
https://issues.apache.org/jira/browse/MNG-6189?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16204646#comment-16204646
 ] 

Wolfgang Fahl commented on MNG-6189:
------------------------------------

I think it would be good to add a pointer to a specific website/blog entry 
explaining what to do. A initial wording could be something like in the answer:

https://stackoverflow.com/a/46743438/1497139

And as simple svn / git diff that shows what things look before and after the 
changes will be much clearer. 
The abstract explanation is in any case far too complicated. When a mvn user 
understands what he really needs to do the move is really simple.

In a wiki with syntax. highlighting things can be explained quite clearly - see
http://wiki.bitplan.com/index.php/MNG-6189

> 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)

Reply via email to