maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "James Green (JIRA)" <>
Subject [jira] [Commented] (MNG-5926) Allow for comment elements inside POM
Date Wed, 04 Nov 2015 07:28:27 GMT


James Green commented on MNG-5926:

Use cases:

1. Why does this dependency need to be here (optionally at this version)?
2. Why does this exclusion exist?

Not sure this answers a somewhat vague question - I hope that's sufficient.

> Allow for comment elements inside POM
> -------------------------------------
>                 Key: MNG-5926
>                 URL:
>             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

View raw message