I've mentioned this in the migration guide: https://github.com/hibernate/hibernate-orm/blob/5.0/migration-guide.adoc#migration-from-502final-to-503final