try to follow Clojure style guide. tweak doc