diff --git a/reference/en/modules/persistent_classes.xml b/reference/en/modules/persistent_classes.xml
index debaec1043..42e969c3b1 100644
--- a/reference/en/modules/persistent_classes.xml
+++ b/reference/en/modules/persistent_classes.xml
@@ -125,6 +125,7 @@ public class Cat {
persist a property with a default, protected or
private get / set pair.
+
@@ -198,6 +199,10 @@ public class Cat {
with Hibernate, but you won't be able to use proxies for lazy association fetching -
which will limit your options for performance tuning.
+
+ You should also avoid declaring public final methods on the
+ non-final classes.
+