Emmanuel,
Some initial thoughts:
* Section 1: replace NoSQL Front-End with NoSQL Back-end? :-)
* Why is this version 3.0? That's pretty arbitrary. ;) Hibernate core is in
v. 4.0, Infinispan is 5.0... maybe this should be a 1.0? Or even 0.1?
* Page 5: Why do you need a @TableGenerator? Is this to demonstrate
compatibility with Hibernate Core annotations? A table generator shouldn't be
required, right?
* I believe the JTA exclusions are fixed in JBoss TS 4.15.0.Final. Will make
the JTA bits look a lot less scary.
* Maybe highlight the lines in persistence.xml that are specific to OGM? I
don't think DocBook will allow you to highlight a line in a code snippet or
make it bold or something, but perhaps an XML comment before the relevant bits?
Something to the effect of
* Good diagrams! Looking at the storage format diagrammatically, it seems as
though what we store is a combination of actual data and indexes (in the
conceptual sense) as well. I.e., you have the ability to look up relationships
directly, without doing a "table scan". Nice. So the drawback (duplicates
data) isn't really a drawback: an RDBMS would do this too, except it would call
it an index. :)
* What are the implications of this 'soft schema' approach?
Cheers
Manik
On 22 Apr 2011, at 17:43, 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-...@lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/infinispan-dev
--
Manik Surtani
ma...@jboss.org
twitter.com/maniksurtani
Lead, Infinispan
http://www.infinispan.org
___
hibernate-dev mailing list
hibernate-dev@lists.jboss.org
https://lists.jboss.org/mailman/listinfo/hibernate-dev