HHH-18129 add to migration guide

Signed-off-by: Gavin King <gavin@hibernate.org>
hibernate · May 16, 2024 · 7992819 · 7992819
1 parent 2563eb3
commit 7992819
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/migration-guide.adoc b/migration-guide.adoc
@@ -106,6 +106,15 @@ class Book {
 ----
 
 
+[[auto-cascade-persist]]
+== Cascading persistence for `@Id` and `@MapsId` fields
+
+Previously Hibernate automatically enabled `cascade=PERSIST` for association fields annotated `@Id` or `@MapsId`.
+This was undocumented and unexpected behavior, and arguably against the intent of the Persistence specification.
+
+Existing code which relies on this behavior should be modified by addition of explicit `cascade=PERSIST` to the association field.
+
+
 [[enum-checks]]
 == Enums and Check Constraints