The need for documentation for a library is not linked to the amount of code it has. In fact, it’s rather sad that the programmer didn’t bother to document such a small thing. It most certainly wouldn’t have been a big task.
Re:A Little Clojure
by willberman on Wednesday April 08, 2020 @01:39AM
(#22810364)
Could you share the 35 line library? I’m curious. I recently asked the Common Lisp subreddit why so many of their libraries lack extensive documentation and most agreed it is a wart on the language.
Re:A Little Clojure
by nickbauman on Wednesday April 08, 2020 @08:51AM
(#22812434)
The one that this first happened with is now much bigger and well documented, oh well.
(FWIW: it's shoreleave https://github.com/shoreleave/shoreleave-remote, it allows for exposing a server-side namespace as a client-side API in the browser).
Why are you comparing a framework to a language? Can I not write a Spring Boot app in Clojure?
Re:A Little Clojure
by regularfry on Wednesday April 08, 2020 @05:51AM
(#22811505)
In this case, I think it's meaningful. If you take https://github.com/scotthaleen/clojure-spring-cloud as a reasonable example of what that would look like, it's (subjectively) ugly as sin. Because you're operating outside idiomatic clojure, there's a lot of incidental complexity and "why would you do it that way?" moments that you wouldn't get with any of the clojure-native, idiomatic web libraries. Yes, you could wrap a lot of it behind more idiomatic facades, but that's still added work you just don't want to have to do.
To be a fair comparison you either need to compare java to clojure or spring boot to whatever the comparable libraries would be in clojure.
Re:A Little Clojure
by nickbauman on Friday April 10, 2020 @05:19PM
(#22837464)
Clojure doesn't really have frameworks, though. Every once in a while a framework-like-thing emerges but it quickly decomposes into a few libraries. The level of composition tends to be functions not objects, so there aren't any "taxonomy traps" associated with monolithic things in the OO world.
I used to freak out when I'd find the library in Clojure I wanted to use but it had no documentation. Eventually I just started looking at the implementation and I'd see it's like the entire library is 35 lines of code! Or like 102 lines of code! You don't need documentation for something that small.
I've never seen this before in other languages. If you think it's too complicated, you might just be overthinking it.