A lesson many projects, including Clojure core, would be wise to internalize:

“Another thing we didn't get right up front was the documentation. We wrote a lot of it, and thought we did a good job, but […]The key missing piece was examples of even the simplest functions. We thought that all you needed to do was say what something did; it took us too long to accept that showing how to use it was even more valuable.”

commandcenter.blogspot.com/202