From 570c584a6c92d5680626f8d39205d9b55de88acb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Herv=C3=A9=20Boutemy?= <hboutemy@apache.org>
Date: Mon, 28 Apr 2025 19:56:44 +0200
Subject: [PATCH 1/4] [MNG-8712] dependency version is a requirement, not
 effective

---
 maven-model/src/main/mdo/maven.mdo | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/maven-model/src/main/mdo/maven.mdo b/maven-model/src/main/mdo/maven.mdo
index 6e33f192fd9c..d104531d5c80 100644
--- a/maven-model/src/main/mdo/maven.mdo
+++ b/maven-model/src/main/mdo/maven.mdo
@@ -1087,8 +1087,10 @@
           <version>3.0.0+</version>
           <description>
             <![CDATA[
-            The version of the dependency, e.g. <code>3.2.1</code>. In Maven 2, this can also be
-            specified as a range of versions.
+            The version requirement of the dependency, e.g. <code>3.2.1</code> for soft version requirement: the effective version will be resolved based on the usage context.
+            In Maven 2, version requirement can also be specified as a range of versions, e.g. <code>[3.2.0,)</code>: notice this is discouraged, as it may break <i>predictability</i> of resolved version.
+            See <a href="https://s.apache.org/dependendy-version">dependency version requirement documentation</a>
+            and <a href="https://s.apache.org/transitive-dependencies-resolution">transitive dependencies resolution</a> for more details.
             ]]>
           </description>
           <type>String</type>

From 2c218e50935c4a31ab500cfb5e993940dd8fab76 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Herv=C3=A9=20Boutemy?= <hboutemy@apache.org>
Date: Tue, 29 Apr 2025 07:37:33 +0200
Subject: [PATCH 2/4] fix reported issues

---
 maven-model/src/main/mdo/maven.mdo | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/maven-model/src/main/mdo/maven.mdo b/maven-model/src/main/mdo/maven.mdo
index d104531d5c80..c903850afad4 100644
--- a/maven-model/src/main/mdo/maven.mdo
+++ b/maven-model/src/main/mdo/maven.mdo
@@ -1088,8 +1088,8 @@
           <description>
             <![CDATA[
             The version requirement of the dependency, e.g. <code>3.2.1</code> for soft version requirement: the effective version will be resolved based on the usage context.
-            In Maven 2, version requirement can also be specified as a range of versions, e.g. <code>[3.2.0,)</code>: notice this is discouraged, as it may break <i>predictability</i> of resolved version.
-            See <a href="https://s.apache.org/dependendy-version">dependency version requirement documentation</a>
+            Version requirement can also be specified as a range of versions, e.g. <code>[3.2.0,)</code>: notice this is discouraged, as it may break <i>predictability</i> of resolved version.
+            See <a href="https://s.apache.org/dependency-version">dependency version requirement documentation</a>
             and <a href="https://s.apache.org/transitive-dependencies-resolution">transitive dependencies resolution</a> for more details.
             ]]>
           </description>

From 647f2d57e40f7a0f92a4addbb526cf819d2f10ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Herv=C3=A9=20Boutemy?= <hboutemy@apache.org>
Date: Wed, 30 Apr 2025 00:33:04 +0200
Subject: [PATCH 3/4] simplification

---
 maven-model/src/main/mdo/maven.mdo | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/maven-model/src/main/mdo/maven.mdo b/maven-model/src/main/mdo/maven.mdo
index c903850afad4..3481151d81f8 100644
--- a/maven-model/src/main/mdo/maven.mdo
+++ b/maven-model/src/main/mdo/maven.mdo
@@ -1087,8 +1087,8 @@
           <version>3.0.0+</version>
           <description>
             <![CDATA[
-            The version requirement of the dependency, e.g. <code>3.2.1</code> for soft version requirement: the effective version will be resolved based on the usage context.
-            Version requirement can also be specified as a range of versions, e.g. <code>[3.2.0,)</code>: notice this is discouraged, as it may break <i>predictability</i> of resolved version.
+            The version requirement of the dependency, e.g. <code>3.2.1</code>. The actual version will be resolved based on the usage context.
+            Version requirement can also be specified as a range of versions, e.g. <code>[3.2.0,)</code>. This is discouraged as it breaks <i>predictability</i> of resolved version.
             See <a href="https://s.apache.org/dependency-version">dependency version requirement documentation</a>
             and <a href="https://s.apache.org/transitive-dependencies-resolution">transitive dependencies resolution</a> for more details.
             ]]>

From 86341cbd52745803bf982bc397f85a87959a9a60 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Herv=C3=A9=20Boutemy?= <hboutemy@apache.org>
Date: Fri, 2 May 2025 00:23:04 +0200
Subject: [PATCH 4/4] version range may break predictability

---
 maven-model/src/main/mdo/maven.mdo | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/maven-model/src/main/mdo/maven.mdo b/maven-model/src/main/mdo/maven.mdo
index 3481151d81f8..181cf35d75f2 100644
--- a/maven-model/src/main/mdo/maven.mdo
+++ b/maven-model/src/main/mdo/maven.mdo
@@ -1088,7 +1088,7 @@
           <description>
             <![CDATA[
             The version requirement of the dependency, e.g. <code>3.2.1</code>. The actual version will be resolved based on the usage context.
-            Version requirement can also be specified as a range of versions, e.g. <code>[3.2.0,)</code>. This is discouraged as it breaks <i>predictability</i> of resolved version.
+            Version requirement can also be specified as a range of versions, e.g. <code>[3.2.0,)</code>. This is discouraged as it may break <i>predictability</i> of resolved version.
             See <a href="https://s.apache.org/dependency-version">dependency version requirement documentation</a>
             and <a href="https://s.apache.org/transitive-dependencies-resolution">transitive dependencies resolution</a> for more details.
             ]]>