On 26 oct. 2010, at 15:17, Kiran Narasareddy wrote: We might have some on the wiki ( http://community.jboss.org/en/hibernate ) but generally no, there is no architectural documentation. We believe in the code being the doc. And the benefit is that it's always up to date :) That being said, Hibernate Core and Search have an architecture section in their reference documentation to understand how the big blocks relate to each other. Hibernate master is using Gradle whereas the legacy branches use Maven. That being said, I imagine that gradle eclipse thingy should work. Can you jump on IRC (freenode #hibernate-dev) to speed up the trial-fix process. We should get this fixed and are working on it in several fronts. yes we use maven