Docs, quite a few docs.

Not sure if we want to be this detailed, but I like well-documented projects and "look at the clojure docs" isn't really good documentation.
do we want this in a comment?