> I feel like with Clojure, I am expected to understand the code just by reading it. Yes, you are. Outside of example code, this seems reasonable to me. If you

> I feel like with Clojure, I am expected to understand the code just by reading it. Yes, you are. Outside of example code, this seems reasonable to me. If you can't understand the code just by reading it and a short docstring, it's a sign the code is too complex. There are cases where such complexity can't be helped, but they're not common.