[maven] branch MNG-7385 updated: comments on removing plugins data

[hb...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

hboutemy pushed a commit to branch MNG-7385
in repository https://gitbox.apache.org/repos/asf/maven.git


The following commit(s) were added to refs/heads/MNG-7385 by this push:
     new bd36bdf  comments on removing plugins data
bd36bdf is described below

commit bd36bdf40e4888430753e79da5f0c63e32070b14
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Tue Jan 18 08:27:45 2022 +0100

    comments on removing plugins data
---
 maven-repository-metadata/src/site/apt/index.apt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/maven-repository-metadata/src/site/apt/index.apt b/maven-repository-metadata/src/site/apt/index.apt
index 26e0649..6246319 100644
--- a/maven-repository-metadata/src/site/apt/index.apt
+++ b/maven-repository-metadata/src/site/apt/index.apt
@@ -56,3 +56,9 @@ Maven Repository Metadata Model
    * a {{{./repository-metadata.html}Descriptor Reference}}.
  
  Notice: data about plugins in a directory representing a groupId is deprecated and will be removed in a future Maven version.
+~~ logic behind this:
+~~ 1. maven-compat will be removed from future Maven version
+~~ 2. this will remove the code that updates plugins data: see MNG-7375/MPLUGIN-384 https://maven.apache.org/ref/3.8.4/maven-compat/apidocs/org/apache/maven/artifact/repository/metadata/GroupRepositoryMetadata.html
+~~ 3. this will lead to inconsistent data: removing it will be safer/more clear
+~~ but this logic still remains to be confirmed by clear consensus of the whole team
+ 
\ No newline at end of file