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