On Thu, Mar 27, 2014 at 5:36 AM, Hardy Ferentschik <hardy(a)hibernate.org>wrote:
On 26 Jan 2014, at 22:29, Steve Ebersole <steve(a)hibernate.org> wrote:
> BTW, here is the topical guide I have started for this:
Very good start. Missing the more complicated cases with explicit class
leave specified access type and overrides on the attributes, but it for
sure helps understanding the whole concepts.
Hence the phrase "started" ;)
Really like the idea of topical guides more and more. I think they
only valuable for users of ORM, but also for us. They document
assumptions/behaviour which help understanding
decisions made in the code.
Definitely. Good documentation/guides are for more than users. They help
us as developers understand the expectations and intentions. They act as
"organizational memory". And they help us write and debug tests wrt those
expectations and intentions.