If you have some specific changes you have in mind we'd love to see a patch/pull request.

That said, that manual is no longer the correct doc. Instead, have a look at https://docs.jboss.org/hibernate/orm/5.0/userGuide/en-US/html_single/#domainmodel-pojo-equalshashcode