        (pls/convert-to-schema db-schema-out)))
 
 (defn configure-read-db
-  "Validates, defaults and converts an incoming (INI file based) read database config returns a config
-   that includes the new read-database config"
+  "Validates, defaults and converts the given `config` (i.e. created from a user provided PuppetDB config),
+   to a read database config"
   [{:keys [global read-database database] :as config}]
   (let [db-config (pls/strip-unknown-keys database-config-out
                                           (if read-database

         configure-logging!
         validate-vardir
         configure-web-server
         convert-ini-map-config
         configure-catalog-debugging)))



    (s/validate command-processing-out converted-config)
    (assoc config :command-processing converted-config)))

(defn convert-config
  "Given a `config` map (created from the user defined config), validate, default and convert it
   to the internal Clojure format that PuppetDB expects"
  [config]
  (-> config
      configure-dbs
