diff --git a/migration-guide.adoc b/migration-guide.adoc
index 1614b2d284..4fd6f635a1 100644
--- a/migration-guide.adoc
+++ b/migration-guide.adoc
@@ -9,6 +9,11 @@ earlier versions, see any other pertinent migration guides as well.
 
 == Known changes
 
+=== Optional Javassist
+
+Javassist is not a transitive dependency of Hibernate ORM core anymore. If you are using it in your
+project you will have to make sure to include it in the classpath of your application.
+
 === Overriding Delayed Identity Insert Behavior
 
 In Hibernate 5.3, we added support for `DelayedPostInsertIdentifier` behavior to be influenced based on the