I think the docs are pretty good, but the main "problem" is the same problem as anything else in Clojure: you have a lot of options, and maybe even documentation, but not a lot of guidance. Which I don't think the community broadly views as much of a problem, but it does make it difficult for new people getting into the language.
There are some within the community working on this but unless it becomes a blessed solution it can still be kinda difficult for new developers to onramp into the language.
E.g. compared to something like Elixir, the road is much more arduous with Clojure.
The problem with things like spec is it kills interest in other libraries solving the same problem. Note that Malli released after spec, and after spec all but killed off a few spec-like libraries, my general observation seems to be that many in the community have moved on from spec.
There are some within the community working on this but unless it becomes a blessed solution it can still be kinda difficult for new developers to onramp into the language.
E.g. compared to something like Elixir, the road is much more arduous with Clojure.
The problem with things like spec is it kills interest in other libraries solving the same problem. Note that Malli released after spec, and after spec all but killed off a few spec-like libraries, my general observation seems to be that many in the community have moved on from spec.