You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "gh-andre (via GitHub)" <gi...@apache.org> on 2026/06/06 12:43:37 UTC
[I] Incorrect version examples with SemVer v2 build metadata, which is not allowed in POM versions [maven-site]
gh-andre opened a new issue, #1595:
URL: https://github.com/apache/maven-site/issues/1595
### Bug description
In this section describing recommended version naming:
https://maven.apache.org/guides/mini/guide-naming-conventions.html#version-identifier
, the examples show build metadata:
```
// Build metadata
1.2.3+dfc0c87
2.3.4+15433
```
However, SemVer v1, which is explicitly referenced at the top of the section, does not define syntax build metadata.
Moreover, POM's detailed guide below explicitly calls out that the `+` character has no special meaning in POM.
https://maven.apache.org/pom.html#version-order-specification
> Important: This is only true for Semantic Versioning 1.0.0. The Maven version order algorithm is not compatible with Semantic Versioning 2.0.0. In particular, Maven does not special case the plus sign or consider build identifiers.
In addition to removing the incorrect examples, I would also suggest adding an explicit note about `+` not considered as a special character, so build metadata, if present, will be considered as a Maven qualifier. Might also be worth mentioning SemVer case sensitivity is ignored in Maven version comparisons.
### Maven site URL where bug exists
https://maven.apache.org/guides/mini/guide-naming-conventions.html#version-identifier
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@maven.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Incorrect version examples with SemVer v2 build metadata, which is not allowed in POM versions [maven-site]
Posted by "elharo (via GitHub)" <gi...@apache.org>.
elharo closed issue #1595: Incorrect version examples with SemVer v2 build metadata, which is not allowed in POM versions
URL: https://github.com/apache/maven-site/issues/1595
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@maven.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Incorrect version examples with SemVer v2 build metadata, which is not allowed in POM versions [maven-site]
Posted by "gh-andre (via GitHub)" <gi...@apache.org>.
gh-andre commented on issue #1595:
URL: https://github.com/apache/maven-site/issues/1595#issuecomment-5242246362
It's unfortunate that incorrect documentation examples are left alone and will continue confuse people about Maven versioning.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@maven.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org