Add a bunch of annoying comments

Figured it might help explain some of the design choices to folks
not so familiar with Clojure. Probably would have been better to do
this with Github comments, but meh.