HV-2015 Cleanup persistence version usage, add todo for enforcer rule

Author: marko-bekhta

documentation/pom.xml

@@ -295,7 +295,7 @@
 
                         <jdkVersion>${java-version.main.release}</jdkVersion>
                         <compilerPluginVersion>${version.compiler.plugin}</compilerPluginVersion>
-                        <versionJakartaPersistence>${version.jakarta.persistence}</versionJakartaPersistence>
+                        <versionJakartaPersistence>${parsed-version.jakarta.persistence-api.majorVersion}.${parsed-version.jakarta.persistence-api.minorVersion}</versionJakartaPersistence>
 
                         <!-- URLs -->
                         <javaApiDocsUrl>${java.api-docs.base-url}/</javaApiDocsUrl>

pom.xml

@@ -124,7 +124,6 @@
 
         <!-- Dependencies versions -->
 
-        <version.jakarta.validation-api>3.1.0</version.jakarta.validation-api>
         <version.jakarta.validation.validation-tck>3.1.1</version.jakarta.validation.validation-tck>
 
         <version.com.thoughtworks.paranamer>2.8</version.com.thoughtworks.paranamer>
@@ -163,6 +162,14 @@
         <version.org.jboss.weld.weld>6.0.0.Beta4</version.org.jboss.weld.weld>
         <version.org.wildfly.arquillian>5.0.0.Alpha3</version.org.wildfly.arquillian>
         <version.jakarta.jakartaee-bom>11.0.0-M4</version.jakarta.jakartaee-bom>
+        <!--
+            These are now managed by the BOM ^ but we want to have version properties available to us
+            so that we can use them elsewhere, e.g. in asciidoc files.
+
+            TODO: add an enforcer rile to check that the versions in these properties are aligned with the ones
+             coming from the BOM.
+        -->
+        <version.jakarta.validation-api>3.1.0</version.jakarta.validation-api>
         <version.jakarta.persistence-api>3.2.0</version.jakarta.persistence-api>
 
         <!-- JavaMoney dependencies -->
@@ -357,7 +364,6 @@
         <!-- Maven version required for the build -->
         <!-- Remember to update README when changing the version here. -->
         <maven.min.version>3.9.6</maven.min.version>
-        <version.jakarta.persistence>3.2</version.jakarta.persistence>
     </properties>
 
     <dependencyManagement>
@@ -628,6 +634,16 @@
                             <versionString>${version.jakarta.validation-api}</versionString>
                         </configuration>
                     </execution>
+                    <execution>
+                        <id>parse-jakarta-persistence-spec-version</id>
+                        <goals>
+                            <goal>parse-version</goal>
+                        </goals>
+                        <configuration>
+                            <propertyPrefix>parsed-version.jakarta.persistence-api</propertyPrefix>
+                            <versionString>${version.jakarta.persistence-api}</versionString>
+                        </configuration>
+                    </execution>
                 </executions>
             </plugin>
         </plugins>