I admit that the complaints about the lack of examples in the documentation does confuse me a bit. The documentation sites for C and C++ don't seem to include examples either. For me, tutorials and books were always the go to places for examples. I will agree whole heartedly that some of the 3rd party libraries like ring/compojure need some serious documentation improvement, in particular since the architecture of these libraries is fairly complicated.
Could someone link examples of good documentation they like from other languages to help clarify?
Making C/C++ documentation the standard for documentation is like making a Chevy Nova the standard for features in modern automobiles.
Another example of documentation that has served me well is the numpy+scipy+matplotlib combo: