[MNG-5782] Provide better documentation for deprecations in Maven 3

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Auto Closed
• Affects Version/s: 3.0
• Component/s: Documentation: General
• Assignee: Unassigned
• Reporter: Sergei S. Ivanov
• Created: 09/Mar/15 18:45
• Updated: 16/Mar/18 22:39
• Resolved: 16/Mar/18 22:39

Description

Quite a few classes and methods in Maven core API have been marked as deprecated as of Maven 3. Unfortunately, there is no documentation in the code, which suggests what the valid alternatives might be. This creates a lot of uncertainty for independent plugin developers, who are not privy to the internal design and implementation decisions made by Maven core team.

A few examples off the top of my head:

• the entire ArtifactFactory interface
• all but one of ArtifactResolver interface methods
• MavenProject.getCompileArtifacts() method
• MavenProject.getTestArtifacts() method

I know that some functionality is now being implemented by Aether, but using Aether directly is not an option if a compatibility with Maven [3.0, 3.1) is required.

Can you please provide javadoc for deprecated interfaces and methods, explaining in greater detail the alternatives and the suggested migration path.