I think the docs have a lot to gain. If you take a look at https://clojuredocs.org/clojure.core/reify as an example, it's pretty much impossible to figure out what the heck reify does by reading that page.

That's not universally the case, but definitely a frustration. The examples are frequently the only way I can begin to figure out the usage of something at all (and they're typically the simplest-case example). I love examples in general, but it still speaks to the difficulty of parsing through some of those function documentations.