While working on the NHibernate Documentation, I’m drawing some pretty pictures. I actually never liked the architecture diagrams much, because I never knew what exactly they are trying to show.

The original architecture diagram looks like this:

I never found this diagram very helpful. (When I started learning NH, Transient Objects and Persistent Objects were very confusing to me. Are this different classes?)

So I decided to rework it. I ended up with something that is not very different from the existing diagrams so:

I shouldn’t cover all the little details of the NHibernate’s internal design, just the concepts that are visible to the user.

What do you think: is this kind of useful?