diff --git a/java/migration.md b/java/migration.md
index 8d7cf5f61..927f9d324 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -138,6 +138,14 @@ None
 3. Changed default value of properties:
 None
 
+### Changes in the `cds-services-archetype`
+
+The `cds-services-archetype` is used by the `@sap/cds-dk` to generate initial CAP Java projects.
+
+#### Default JDK version
+
+The default JDK version of new CAP Java projects has been changed to JDK **25**. The minimum required JDK version is still 17, this has not been changed.
+
 ### Removed repackaged Olingo Dependencies { #removed-olingo-4-to-5 }
 
 The internally used maven modules `repackaged/odata-v4-lib` and `repackaged/odata-v2-lib` are removed from the delivery. If the project directly references these modules and doesn't compile after migrating to CAP Java 5.x, there are 3 options to keep the compatibility of the code base: