diff --git a/migration-guide.adoc b/migration-guide.adoc
index 62f5f1074a..bf2356fb7c 100644
--- a/migration-guide.adoc
+++ b/migration-guide.adoc
@@ -63,6 +63,19 @@ private Employee manager;
 ----
 
 
+[[java-beans]]
+== JavaBean Conventions
+
+Previous versions allowed some, at beast, questionable attribute naming patterns.  These are no longer supported.  E.g.
+
+[source,java]
+----
+@Basic
+String isDefault();
+----
+
+
+
 [[cleanup]]
 == Some Cleanup