From 916edecc71e616573eefc0c4ed7a867fff82a276 Mon Sep 17 00:00:00 2001
From: Robin de Silva Jayasinghe <r.de.silva.jayasinghe@sap.com>
Date: Tue, 2 Jun 2026 12:32:23 +0200
Subject: [PATCH 1/2] =?UTF-8?q?docs(java):=20add=20property=20default=20ch?=
 =?UTF-8?q?anges=20and=20removals=20for=204.9=20=E2=86=92=205.0=20migratio?=
 =?UTF-8?q?n?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Documents the 7 adjusted property defaults and the 1 removed property
(cds.errors.combined) in the CAP Java 4.9 to 5.0 migration guide,
replacing the placeholder comment block.
---
 java/migration.md | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/java/migration.md b/java/migration.md
index 8d7cf5f61..692a1cbfe 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -71,21 +71,19 @@ CAP Java 5.0 increased some minimum required versions:
 | XSUAA (BTP Security Library) | 4.0.0 |
 | Maven | 3.9.10 |
 
-<!-- ### Adjusted Property Defaults
+### 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. This reflects its intended behavior once the properties are deleted in future releases.
+| `cds.security.authentication.mode` | `model-strict` | `model-relaxed` | Authentication mode now defaults to `model-relaxed`, which only enforces authentication for endpoints protected via `@requires` or `@restrict`. |
+| `cds.odataV2.batch.maxRequests` | `-1` (unlimited) | `10` | OData V2 batch requests are now limited to 10 by default to protect against overload. |
+| `cds.sql.toOnePath.mode` | `always-join` | `optimize` | SQL generation now avoids joins for to-one path expressions when a FK column can be selected directly, improving query performance. |
+| `cds.errors.preferServiceException` | `false` | `true` | `ServiceException` is now preferred over generic exceptions when mapping errors to HTTP responses. |
+| `cds.outbox.services.<key>.ordered` | `true` | `false` | Outbox instances now process entries in parallel by default. Set to `true` to restore ordered, single-threaded processing. |
+| `cds.multitenancy.serviceManager.cacheRefreshInterval` | `PT20M` (20 min) | `PT60M` (60 min) | The service manager cache is now refreshed less frequently to reduce overhead. |
+| `cds.persistence.changeSet.enforceTransactional` | `true` | `false` | Transactional enforcement for change sets is now opt-in. |
 
 ### Removed Properties
 
@@ -93,7 +91,7 @@ The following table gives an overview about the removed properties:
 
 | Removed Property | Replacement / Explanation |
 | --- | --- |
-| `abc` | Any description about replacement | -->
+| `cds.errors.combined` | Was deprecated since CAP Java 4.0. The property had no effect anymore and has been removed. |
 
 ### Removed Java APIs { #removed-java-apis-4-to-5 }
 

From 05ef49d676abb6f4386be4afbb7926258bf248c1 Mon Sep 17 00:00:00 2001
From: Robin de Silva Jayasinghe <r.de.silva.jayasinghe@sap.com>
Date: Tue, 2 Jun 2026 13:02:53 +0200
Subject: [PATCH 2/2] =?UTF-8?q?docs(java):=20add=20cds.query.deepEntityRea?=
 =?UTF-8?q?donly=20default=20change=20to=204.9=E2=86=925.0=20migration=20g?=
 =?UTF-8?q?uide?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 java/migration.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/java/migration.md b/java/migration.md
index 692a1cbfe..902be53c5 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -84,6 +84,7 @@ Some property defaults have been adjusted:
 | `cds.outbox.services.<key>.ordered` | `true` | `false` | Outbox instances now process entries in parallel by default. Set to `true` to restore ordered, single-threaded processing. |
 | `cds.multitenancy.serviceManager.cacheRefreshInterval` | `PT20M` (20 min) | `PT60M` (60 min) | The service manager cache is now refreshed less frequently to reduce overhead. |
 | `cds.persistence.changeSet.enforceTransactional` | `true` | `false` | Transactional enforcement for change sets is now opt-in. |
+| `cds.query.deepEntityReadonly` | `false` | `true` | Readonly handling is now enforced for deep entity reads by default. |
 
 ### Removed Properties