Hibernate client refactoring/doc update. Fixes #35