[Macha]

Yeah, enterprise java tech in general (not just hibernate) seems to be some of the worst. There's enough terminology collision and incentive for blogspam with the number of corporate users, but not enough interest in people using it for personal reason to have high quality blogs, and core pieces of it (Hibernate, Spring, Jackson for example) have shockingly poorly organised documentation.