The discussion in http://docs.jboss.org/hibernate/orm/5.1/topical/html_single/generated/GeneratedValues.html really ought to exist in the UserGuide as well.