anchor.diff:  with attributes possibly introduced by Hibernate OGM in future releases.
   ====
   
  -Embedded objects are mapped as nested documents.
  -The following listing shows an example:
  -
  -.Example of an entity with an embedded object
  -====
  -[source, JAVA]
  -----
  -@Entity
  +.Rename field and collection using @Table and @Column
  +====
  +[source, JAVA]
  +----
  +@Entity
  +@Table(name="Article")
   public class News {
   
       @Id
  +    @Column(name="code")
       private String id;
   
       @Version
  
positive.code: depending if the mapping concerns a single object or a collection.
  The field that stores the relationship information is named like the entity property.
  
  .Java entity
  ====
  [source, JAVA]
  
negative.code: and update the same datastore.
  The following describe how entities and associations are mapped to CouchDB documents by Hibernate OGM.
  
  [[couchdb-built-in-types]]
  ===== Builtin types
  
  Hibernate OGM support by default the following types:
  
  * [classname]+java.lang.String+
  
  [source, JSON]
  ----
    { "text" : "Hello world!" }
  ----
  
  * [classname]+java.lang.Boolean+ (or boolean primitive)
  
  [source, JSON]
  ----
    { "favorite" : true }
  ----
  
  * [classname]+java.lang.Byte+ (or byte primitive)
  
  [source, JSON]
  ----
    { "display_mask" : "70" }
  ----
  
  * [classname]+java.lang.Long+ (or long primitive)
  
  [source, JSON]
  ----
    { "userId" : "-6718902786625749549" }
  ----
  
  * [classname]+java.lang.Integer+ (or integer primitive)
  
  [source, JSON]
  ----
    { "stockCount" : 12309 }
  ----
  
  * [classname]+java.lang.Double+ (or double primitive)
  
  [source, JSON]
  ----
    { "tax_percentage" : 12.34 }
  ----
  
  * [classname]+java.math.BigDecimal+
  
  [source, JSON]
  ----
    { "site_weight" : "21.77" }
  ----
  
  * [classname]+java.math.BigInteger+
  
  [source, JSON]
  ----
    { "site_weight" : "444" }
  ----
  
  * [classname]+java.util.Calendar+
  
  [source, JSON]
  ----
    { "creation" : "2014-11-18T15:51:26.252Z" }
  ----
  
  * [classname]+java.util.Date+
  
  [source, JSON]
  ----
    { "last_update" : "2014-11-18T15:51:26.252Z" }
  ----
  
  * [classname]+java.util.UUID+
  
  [source, JSON]
  ----
    { "serialNumber" : "71f5713d-69c4-4b62-ad15-aed8ce8d10e0" }
  ----
  
  * [classname]+java.util.URL+
  
  [source, JSON]
  ----
    { "url" : "http://www.hibernate.org/" }
  ----
  
  =
  ===== Entities
  
  Entities are stored as CouchDB documents and not as BLOBs
  