I just watch a great video by @bozhidar highlighting the challenges faced by Clojure documentation. Very relevant to the issues we've been discussing here. https://www.youtube.com/watch?v=nrpsMB2gYI0