sbglasius commented on code in PR #16141:
URL: https://github.com/apache/grails-core/pull/16141#discussion_r3773342442


##########
grails-doc/src/en/guide/upgrading/upgrading80x.adoc:
##########
@@ -993,16 +994,111 @@ The `@Tag`-annotated method itself produces no 
compile-time warning, because pre
 
 ==== 23. Known Plugin Incompatibilities
 
-Some third-party plugins have not yet been updated for Spring Boot 4 / Spring 
Framework 7 compatibility.
-The following are known blockers at this time:
+A Grails 7 plugin is not automatically incompatible with Grails 8. A plugin 
resolving, appearing in the load order, and letting the application start is 
encouraging, but it is not enough to establish compatibility. Exercise the 
plugin's documented public behavior, including web requests, outbound calls, 
serialization, commands, and any domain traits or annotations it exposes.
 
-* **grails-spring-security** - Uses `ReflectionUtils.getApplication()` which 
was removed in Spring Boot 4.
-Integration tests for modules depending on Spring Security are disabled until 
the plugin is updated.
+When a released Grails 7 plugin fails, first check whether the maintainer has 
published a Grails 8 version. Some failures have a temporary application-side 
workaround. Others are binary incompatibilities in already-published bytecode 
and require the plugin author to rebuild and release the plugin against Grails 
8. Do not add framework-internal compatibility classes to an application to 
work around those failures.
 
-* **SiteMesh 3** - The decorator/layout mechanism is not compatible with 
Spring Framework 7.
-Applications using `grails-sitemesh3` should remain on the `grails-layout` 
plugin (SiteMesh 2.6.x) until SiteMesh 3 is updated.
+Use the first distinctive failure to choose the next step:
 
-Check the https://github.com/apache/grails-core/issues[Grails issue tracker] 
for the latest status of plugin compatibility.
+* `NoClassDefFoundError` mentioning 
`com/fasterxml/jackson/databind/exc/InvalidDefinitionException` while creating 
`OrderedFormContentFilter`: add the BOM-managed Jackson 2 `jackson-databind` 
dependency described below, then retest the plugin's public behavior.
+* `Could not find org.grails:...:.`: use a plugin version built against 
`org.apache.grails`, or use narrowly targeted dependency substitution as a 
temporary migration aid.

Review Comment:
   Should it  be mentioned, that `org.grails` is often pre. Grails 7?



-- 
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]

Reply via email to