diff --git a/java/migration.md b/java/migration.md
index 0af8605a0..e7008b982 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -171,6 +171,11 @@ The `cds-services-archetype` is used by the `@sap/cds-dk` to generate initial CA
 
 The default JDK version of new CAP Java projects has been changed to JDK **25**. The minimum required JDK version is now **21**.
 
+If your project uses Lombok, you need to explicitly add its annotation processor to your POM when you switch to Java 25. This is a change in Java compiler and affects all other annotation processors. 
+
+[Learn more about Maven setup with Lombok.](https://projectlombok.org/setup/maven){.learn-more}
+[Learn more about about the change in the Java compiler.](https://bugs.java.com/bugdatabase/JDK-8321314/description){.learn-more}
+
 ### 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: