[MNG-6189] WARN if maven-site-plugin configuration contains reportPlugins element

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.5.0-alpha-1
• Fix Version/s: 3.5.0-beta-1, 3.5.0
• Component/s: Inheritance and Interpolation, Sites & Reporting
• Assignee: Herve Boutemy
• Reporter: Herve Boutemy
• Created: 19/Mar/17 14:57
• Updated: 18/Jun/22 21:07
• Resolved: 20/Mar/17 07:25

Description

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

Issue Links

• is duplicated by: MNG-5463 warn if maven-site-plugin's reportPlugins is configured in POM
• is related to: MNG-7504 Warning about unknown reportPlugins parameters for m-site-p are always generated
• is related to: MSITE-792 drop reportPlugins parameter ("new format")
• relates to: MNG-4162 Removal of all reporting logic from the core of Maven
• relates to: MSITE-647 reduce visibility of the new reportPlugins format documentation waiting for better support