diff --git a/documentation/src/main/asciidoc/introduction/Entities.adoc b/documentation/src/main/asciidoc/introduction/Entities.adoc index 3e6593a9115e..8ad97a494825 100644 --- a/documentation/src/main/asciidoc/introduction/Entities.adoc +++ b/documentation/src/main/asciidoc/introduction/Entities.adoc @@ -778,6 +778,14 @@ On the other hand, if we _don't_ set `autoapply=true`, then we must explicitly a EnumSet daysOfWeek; ---- +[CAUTION] +==== +Converters are supposed to be used for type conversion. +Some enterprising members of the community have noticed that they can be (mis)used to perform other tasks: trimming whitespace, normalizing case, assigning a default value in place of `null`, and so on. +Hibernate _tolerates_ but does not encourage such (mis)use. +In particular, we strongly recommend against defining an `autoApply` converter acting on a <>. +==== + All this is nice, but it probably won't surprise you that Hibernate goes beyond what is required by JPA. [[compositional-basic-types]]