matrei commented on code in PR #15319:
URL: https://github.com/apache/grails-core/pull/15319#discussion_r2705440185
##########
grails-doc/src/en/guide/upgrading/upgrading60x.adoc:
##########
@@ -104,6 +104,82 @@ You can override a version in the BOM by setting the
associated Gradle property.
The possible gradle properties are generated as part of this documentation.
Please see link:{versionsRef}Grails BOM.html[Grails BOM Dependencies] for a
quick reference.
+===== 4.1 BOM Property Changes
+
+The initial Grails 7.0.0 release had an issue where properties in the bom were
not correctly populated. The 7.0.4 release restored properties, but the naming
was inconsistent and duplicated. Later versions of Grails 7 reworked the
properties for the following reasons:
+
+* to follow previous naming strategies used by Grails 6 and earlier.
+* to remove duplicate properties.
+* to clearly delineate between profile dependencies.
+* to remove non-published projects.
+* to fix invalid versions for properties used by asciidoctor & rxjava.
+
+Detailed differences follow in subsequent sections.
+
+===== 4.2 Property Name Standardization
+
+In the prior 7.0.0 Grails versions, there were numerous duplicated properties
for third-party dependencies, with one variant using hyphens (e.g.,
byte-buddy.version) and an identical one using dots (e.g., byte.buddy.version),
both set to the same value. This applies to properties like:
+
+ asset-pipeline-gradle.version / asset.pipeline.gradle.version
+ byte-buddy.version / byte.buddy.version
+ commons-text.version / commons.text.version
+ directory-watcher.version / directory.watcher.version
+ grails-publish-plugin.version / grails.publish.version (though this is
slightly inconsistent in naming)
+ javaparser-core.version / javaparser.core.version
+ bootstrap-icons.version / bootstrap.icons.version (literal duplicate
entries)
+ commons-codec.version / commons.codec.version
+ geb-spock.version / geb.spock.version
+ asset-pipeline-bom.version / asset.pipeline.bom.version
+ spock.version / spock.bom.version (values match but names differ slightly)
+ jackson.version / jackson.bom.version
+ groovy.version / groovy.bom.version
+ selenium.version / selenium.bom.version
+
+To resolve this duplication and standardize naming conventions, the Grails
team has consolidated these properties. All dotted variants have been removed.
Only the hyphenated forms are retained (e.g., byte-buddy.version,
asset-pipeline-gradle.version).
+
+Additionally, Grails-specific properties in earlier Grails 7 versions used
dots in their names (e.g., grails.async.version,
grails.data.hibernate5.version). These have been refactored to use hyphens
instead (e.g., grails-async.version, grails-data-hibernate5.version). This
aligns them with the third-party property naming convention.
+
+These changes eliminate redundancy and enforce consistency across the Grails
bom & the boms it inherits.
+
+===== 4.3 Profile Properties are renamed
+
+In previous Grails 7 versions, profile-specific properties were not prefixed
with `grails-profile`. These have been corrected as follows:
+
+ base.version - grails-profile-base.version
+ plugin.version - grails-profile-plugin.version
+ profile.version - grails-profile-profile.version
+ rest.api.version - grails-profile-rest-api.version
+ rest.api.plugin.version - grails-profile-rest-api-plugin.version
+ web.version - grails-profile-web.version
+ web.plugin.version - grails-profile-web-plugin.version
+
+===== 4.4 Removal of Redundant or Unused Properties
+
+Several groups of related properties have been consolidated or removed in
later Grails 7 versions:
+
+* Liquibase: (liquibase-hibernate5.version, liquibase.version,
liquibase.cdi.version, liquibase.core.version, liquibase5.hibernate.version)
have been replaced by `liquibase-hibernate5.version`
+* MongoDB: (mongodb.version, bson.version, mongodb.driver.core.version,
mongodb.driver.sync.version, bson.record.codec.version) have been replaced by
`mongodb.version`
+* Sitemesh: (starter-sitemesh.version, spring.boot.starter.sitemesh.version)
have been consolidated to `starter-sitemesh.version`
+* Ant: (ant.version and ant.junit.version) have been consolidated to
`ant.junit.version`
Review Comment:
I think this is consolidated to `ant.version`.
--
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]
