diff --git a/java/migration.md b/java/migration.md
index 6973a7e87..d020241fb 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -66,6 +66,38 @@ CAP Java 5.0 increased some minimum required versions:
 | Spring Boot | 4.0 |
 | XSUAA (BTP Security Library) | 4.0.0 |
 
+### Adjusted Property Defaults
+
+Some property defaults have been adjusted:
+
+| Property | Old Value | New Value | Explanation |
+| --- | --- | --- | --- |
+| `abc` | false | true | Any description. |
+
+### Deprecated Properties
+
+The following properties have been deprecated and might be removed in a future major version:
+
+- `abd`
+
+The functionality provided by these properties is enabled by default and there is no reason to switch these off.
+
+### Removed Properties
+
+The following table gives an overview about the removed properties:
+
+| Removed Property | Replacement / Explanation |
+| --- | --- |
+| `abc` | Any description about replacement |
+
+### Removed Java APIs
+
+- Removed deprecated classes:
+  - `com.sap.cds.A`, use `B` instead
+
+- Removed deprecated methods:
+  - `com.sap.cds.ql.cqn.A.search(String term)`, use `searchTerm(CqnSearchTermPredicate)` instead
+
 ## CAP Java 3.10 to CAP Java 4.0 { #three-to-four }
 
 ### New License