[MNG-7385] Improve documentation on repository metadata

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.8.4
• Fix Version/s: 3.8.5, 4.0.0-alpha-2, 4.0.0
• Component/s: Artifacts and Repositories
• Assignee: Herve Boutemy
• Reporter: Herve Boutemy
• Created: 09/Jan/22 18:10
• Updated: 06/Sep/23 05:43
• Resolved: 18/Jan/22 20:27

Description

working on MNG-7375, it is clear that current documentation on repository metadata (I wrote in 2020...) needs more details: https://maven.apache.org/ref/3.8.4/maven-repository-metadata/index.html

and there is one specific question to document: given org.apache.maven.artifact.repository.metadata.GroupRepositoryMetadata has been put in maven-compat, it seems it means that plugins information is considered "compat" only and will be removed in the future
=> we need to confirm and document (for example by marking some generated classes as deprecated)

Issue Links

• causes: MNG-7870 Undeprecate wrongly deprecated repository metadata
• relates to: MNG-7375 Potential NPE in o.a.m.artifact.repository.metadata.Metadata.merge(...) with invalid/incomplete plugin metadata
• relates to: MPLUGIN-377 Drop use of legacy APIs
• links to: GitHub Pull Request #654