News for hackers. Stuff that matters.
Re:ClojureDocs – Community-powered documentation and example... by dgb23 on Wednesday June 01, 2022 @05:12PM (#31588195)
This is a great resource, especially because of its killer feature: user provided examples.

Some of the more powerful or special purpose utilities in Clojure are much easier to grasp by looking at some examples.

The only thing that is potentially better is a very well maintained wiki, like the MDN docs. But that’s a much bigger effort and only few wikis reach that level of quality.

Another cool thing about Clojure is that its core library and other parts of the language are quite small and understandable. I had quite a bit of fun reading and skimming the source, trying to understand things etc.

Re:ClojureDocs – Community-powered documentation and example... by dan-robertson on Wednesday June 01, 2022 @06:23PM (#31588903)
I remember very fondly that the php documentation would often have nice practical examples in the comments below the documentation for each function.
Re:ClojureDocs – Community-powered documentation and example... by agumonkey on Thursday June 02, 2022 @02:33AM (#31592080)
Yes, for all its warts, PHP.net docs were fun to read due to short convos with user provided code usage. The opposite of javadocs.
Re:ClojureDocs – Community-powered documentation and example... by uvtc on Thursday June 02, 2022 @01:14PM (#31597713)
> killer feature: user provided examples

I agree. [Janet](https://janet-lang.org/) (which, coincidentally, has some superficial similarities to Clojure) has something similar at its [JanetDocs site](https://janetdocs.com/).