[jira] [Created] (MNG-6681) improve documentation: dependency type = classifier+extension+additional hints

["Hervé Boutemy (JIRA)" <ji...@apache.org>]

Hervé Boutemy created MNG-6681:
----------------------------------

             Summary: improve documentation: dependency type = classifier+extension+additional hints
                 Key: MNG-6681
                 URL: https://issues.apache.org/jira/browse/MNG-6681
             Project: Maven
          Issue Type: Task
    Affects Versions: 3.6.1
            Reporter: Hervé Boutemy
            Assignee: Hervé Boutemy
             Fix For: 3.6.2


Documentation for dependency type is currently misleading: [https://maven.apache.org/ref/3.6.1/maven-model/maven.html#class_dependency]
 ??The type of dependency. While it usually represents the extension on the filename of the dependency, that is not always the case. A type can be mapped to a different extension and a classifier. The type often corresponds to the packaging used, though this is also not always the case. Some examples are jar, war, ejb-client and test-jar??
 Reading that, people understand that type is extension

This has to be rephrased a little bit to have people keep in mind: *A type can be mapped to an extension and a classifier (and the extension value may match the type, but not always)*

The "While it usually represents the extension on the filename of the dependency, that is not always the case." as first explanation is totally misleading



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)