             remote-version (.mostRecentVersion remote-store)]
         (when (and local-version remote-version)
           (< local-version remote-version)))))
+
+;; ## Sinking and Sourcing
+;;
+;; These methods allow the user to sink and source objects from the
+;; supplied domain.
 
 ;; ## Domain Tidying
 

;;
;; This is the main function used by a database to build its domain objects.

(defn build-domain
  "Constructs a domain record."
  [local-root hdfs-conf remote-path hosts replication

(defrecord Domain
    [local-store remote-store serializer throttle rw-lock
     hostname status domain-data shard-index]  

  Shutdownable
  (shutdown [this]
    "Shutting down a domain requires closing all of its shards."
