 ;; * `:type` and `:title` are used to produce a `resource-spec` for
 ;;   this resource
 ;;
-;; ### Dependency Specification
-;;
-;; A representation of an "edge" in the catalog. All edges have the
-;; following form:
+;; ### Edge
+;;
+;; A representation of an "edge" (dependency or containment) in the
+;; catalog. All edges have the following form:
 ;;
 ;;     {:source       <resource spec>
 ;;      :target       <resource spec>

;; * `:before`
;; * `:subscription-of`
;;
;; ### CMDB catalog
;;
;; A wire-format-neutral representation of a Puppet catalog. It is a
;; map with the following structure:

;; ## Puppet catalog parsing
;;
;; Functions that handle conversion of catalogs from wire format to
;; internal Grayskull format.
;;
;; The wire format is described in detail in [the
;; spec](../spec/catalog-wire-format.md).
;;
;; There are a number of transformations we apply to wire format
;; catalogs during conversion to our internal format; while wire
;; format catalogs contain complete records of all resources and
;; edges, and most things are properly encoded as lists or maps, there
;; are still a number of places where structure is absent or lacking:
;;
;; 1. Resource specifiers are represented as opaque strings, like
;;    `Class[Foobar]`, as opposed to something like
