From f49e4186a4a739f01cbd0bb1466d0f9a739d35b0 Mon Sep 17 00:00:00 2001 From: Harjot Singh Date: Thu, 18 Jun 2026 03:45:01 +0530 Subject: [PATCH] docs: remove SemVer 2.0.0 build-metadata examples from naming conventions The version-identifier guide recommends Semantic Versioning 1.0.0 but showed `+build` metadata examples (1.2.3+dfc0c87, 2.3.4+15433). That `+` syntax is defined only in SemVer 2.0.0, and Maven explicitly does not special-case the plus sign or treat the trailing text as build metadata; it becomes an ordinary version qualifier. Remove the incorrect examples, drop the "build metadata" wording from the surrounding prose, and add a short note clarifying that `+` has no special meaning in Maven versions, linking to the version order specification in pom.html. Fixes #1595 --- .../markdown/guides/mini/guide-naming-conventions.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/content/markdown/guides/mini/guide-naming-conventions.md b/content/markdown/guides/mini/guide-naming-conventions.md index 67330d90c2..44f9175bfe 100644 --- a/content/markdown/guides/mini/guide-naming-conventions.md +++ b/content/markdown/guides/mini/guide-naming-conventions.md @@ -93,7 +93,7 @@ Examples 3.5.42 ``` -You can add labels for pre-releases or build metadata after the patch version. +You can add labels for pre-releases after the patch version. Avoid using dates in those labels, because they are usually associated with unstable versions. Examples @@ -103,12 +103,12 @@ Examples 1.0.0-beta 1.0.0-M1 1.0.0-rc2 - -// Build metadata -1.2.3+dfc0c87 -2.3.4+15433 ``` +Note that Semantic Versioning 2.0.0 build metadata (e.g. `1.2.3+dfc0c87`) is not recognized as such by Maven. +The `+` character has no special meaning in Maven versions, so any text after it is treated as part of an ordinary +qualifier rather than build metadata. See the [version order specification][5] for details. + ### Unstable versions (SNAPSHOT) `SNAPSHOT`s are artifacts built in between releases. @@ -125,4 +125,5 @@ if one is defined in the [POM file][3]. [2]:https://semver.org/spec/v1.0.0.html [3]:/pom.html#Repository [4]:/pom.html#Maven_Coordinates +[5]:/pom.html#Version_Order_Specification