 ;;  - You've used a Form-1 component where you should use a Form-2 component.
 ;;    See https://github.com/Day8/re-frame/wiki/Creating-Reagent-Components.
 ;;
-;; If it wasn't repeated bind calls, you might want to filter out scratch
-;; changes. At tag filter-scratch you can find a change that introduced that,
-;; but wasn't needed at the time.
+;; If it wasn't repeated bind calls, you might want to exclude scratch changes
+;; from being checked for novelties. At tag filter-scratch you can find a
+;; commit that introduced that, but wasn't needed at the time.
 (defn bind
-  "Returns a ratom containing the result of query Q on the value of the database
-  behind CONN with the arguments Q-ARGS."
+  "Returns a ratom containing the result of query Q with the arguments Q-ARGS on
+  the value of the database behind CONN."
   [q conn & q-args]
   ;(println "bind called" q) ; Commented out on purpose. – See note above.
   (let [k (uuid/make-random-uuid)

      (d/transact! conn txd))))

(defn register-handler
  "Handler registration procedure that provides the right defaults for Theatralia.

  In re-frame, the default handler registration procedure applies only the
  'pure' middleware to a handler. Here we apply the respective 'pure-datascript'

    state))

(defn unbind
  "Stops changes in CONN from causing updates of ratom STATE."
  [conn state]
  (d/unlisten! conn (.-__key state)))

(defn pure-datascript
  "Adaptation of the re-frame middleware 'pure' for Thomsky.

  The HANDLER wrapped in this middleware will receive the current value behind
  CONN and has to return a Datascript transaction data structure that will be
  transact!ed over CONN.

