[hibernate-dev] Another @Access quandry

[Steve Ebersole]

On Thu, Mar 27, 2014 at 5:36 AM, Hardy Ferentschik <hardy at hibernate.org>wrote:

>
> On 26 Jan 2014, at 22:29, Steve Ebersole <steve at hibernate.org> wrote:
>
> > BTW, here is the topical guide I have started for this:
> https://github.com/hibernate/hibernate-orm/blob/f7b779ec60281408da80590ab2b0fdb5b98accf5/documentation/src/main/asciidoc/topical/accesstype/AccessType.adoc
>
> 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 are not
> 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.