[infinispan-dev] Hibernate OGM documentation
Galder Zamarreño
galder at redhat.com
Tue May 31 06:03:33 EDT 2011
Emmanuel,
Just had a read (apologies for the delay) and there's something that's unclear to me:
The "Storing associations" diagram doesn't look right to me. So, you have an address and a user. And then you have an association where you say: user 1 has address 3 and 5. That's fine. But then, you have an association for an address, to find out which addresses it has and I suppose that's the tbl_user_address,addressId_fk,3, correct? If so, the value part doesn't look right. Surely that should tell you the users that have as address the address with id=3? I suppose that'd be user 1 and maybe user 9 for example?
One quick note, whenever we show code examples with transaction work, shouldn't we promote patterns such as the one in http://community.jboss.org/docs/DOC-12691 ? Those patterns, although a bit verbose, guarantee that regardless of the outcome, transactions are either commit or rollback.
Cheers,
On Apr 22, 2011, at 6:43 PM, Emmanuel Bernard wrote:
> Hi all
> I've been working on Hibernate OGM documentation. I am still very unhappy with what I have but that's a start.
>
> You can read it at http://docs.jboss.org/hibernate/ogm/3.0/reference/en-US/html_single/
> You can contribute to it by forking on github https://github.com/hibernate/hibernate-ogm
>
> To build the documentation,
> - go to hibernate-ogm-doucumentation/manual
> - run mvn install -DbuildDocs=true
> You will get the result in target/docbook/publish/en-US
>
> I'm interested in all kind of feedback:
> - general feel
> - what part is confusing
> - what you think is missing (besides the TODOs)
>
> And of course if you can contribute some part, that would be awesome.
>
> Emmanuel
>
>
>
> _______________________________________________
> infinispan-dev mailing list
> infinispan-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/infinispan-dev
--
Galder Zamarreño
Sr. Software Engineer
Infinispan, JBoss Cache
More information about the infinispan-dev
mailing list