 ;;                        :cast-fns {:this ->int})
 
 
-;; # Writer functions
+;; # Output processing functions
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 
 
 ;; As with the input processing functions, the output processing functions are designed to be small, modular
-;; peices you compose as you see fit.
+;; peices you compose together.
 ;; Using these it's expected that you push your data through the processing functions and into a third party
 ;; writer.
-;; But also as with the readers, we offer some higher level, default-opinionated, configurable functions that
-;; do this composing for you, while the emphasis of the library remains with the composable functions.
+;; But as with the input processing functions, we offer some higher level, opinionated but configurable functions
+;; which automate some of this for you.
 ;;
 ;; One of the first things we'll need is a function that takes a sequence of maps and turns it into a sequence
-;; of vectors given column name order:
+;; of vectors since this is what most of our csv writing/formatting libraries will want.
 
 ;; ## vectorize
 

;; ## Structure
;;
;; Semantic CSV _emphasizes_ a number of individual processing functions which can operate on the output of a
;; syntactic csv parser such as `clojure.data.csv` or `clojure-csv`.
;; This reflects a nice decoupling of grammar and semantics, in an effort to make this library as composable
;; and interoperable as possible.
;; However, as a convenience, we offer a few functions which wrap these individual steps with a set of
;; opinionated defaults and an option map for overriding the default behaviour.
;;
;; <br/>


;;              '[clojure-csv.core :as csv]
;;              '[clojure.java.io :as io])
;;
;; Now let's take a tour through some of the processing functions we have available, starting with the input
;; processing functions.
;;
;; <br/>


;; # Input processing functions
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;
;; Note that all of these processing functions leave the rows collection as the final argument.
