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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
