anchor.diff:  you'll probably want to at least review Google's official
   link:https://cloud.google.com/appengine/docs/java/datastore/[Datastore documentation].
   
  -== getting started
  +In no particular order:
  +
  +* <<start,getting started>>
  +* <<testing,testing>>
  +* <<types,types>>
  +* <<ctors,construction>>
  +* <<axioms,axioms>>
  +* <<keys,Keys, keychains, keylinks, dogtags>>
  +* <<kinds,kinds>>
  +* <<autogen,autogenned ids>>
  +* <<fields,field types>>
  +* <<metadata,metadata>>
  +* <<retrieval,retrieval>>
  +* <<co-ctors,co-construction>>
  +* <<queries,queries>>
  +* <<mutation,mutation>>
  +
  +== [[start]]getting started
   
   **NOTE:** you do not need an App Engine account to explore this
     library in a development environment.  The gradle build system will
  
positive.code: (entity-map! :force [:A/B] {:a 9 :b 10}) ;; force replacement
  ----
  
  === structural axioms
  
  [[app-listing]]
  [source,clojure]
  
negative.code: 
  TODO: support all datastore property types.
  
  == [[metadata]] metadata
  
  == [[retrieval]] retrieval
  
  We treat the datastore as just another map: `(get datastore k)`
  retrieves the entity-map whose keychain is `k`.  Since there is only
  one datastore, we sugar this to `(get-ds k)`.
  
  == [[co-ctors]] experimental:  co-construction
  
  [source,clojure]
  ----
  (entity-map* [:A/B]) ;; "co-constructs" (retrieves) entity with key [:A/B] if it exists, otherwise throws exception
  ----
  
  == [[queries]] queries
  
  **NB**: these query patterns are experimental and very likely to change.
  
  