[ https://issues.apache.org/jira/browse/MNG-5926?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15724745#comment-15724745 ]
Jochen Wiedmann commented on MNG-5926: -------------------------------------- Sorry, but I don't get, why XML comments aren't sufficient for you. What's the problem with those? > Allow for comment elements inside POM > ------------------------------------- > > Key: MNG-5926 > URL: https://issues.apache.org/jira/browse/MNG-5926 > Project: Maven > Issue Type: Improvement > Components: POM > Reporter: James Green > Priority: Trivial > Fix For: Issues to be reviewed for 4.x > > > I have spent hours tracking down why something exists as it does within a > company POM. On multiple occasions. > All because there is no obvious documentation for things like dependencies. > Yes, we could use XML comments but these will not show in the results of any > documentation tools. > What I am asking for is a <comment> element to be permitted within a > <dependency>, <exclusion>, and probably a few other areas but those are real > immediate areas of need. > This was discussed briefly on the -users mailing list many months ago and was > generally met with approval. I can't remember adding it here though... -- This message was sent by Atlassian JIRA (v6.3.4#6332)