Have updated documentation as per bug description. Kindly review.
https://github.com/hibernate/hibernate-orm/pull/2784