docs

About docs of Clojure & libs
Jakub Holý 2018-07-24T09:55:47.000237Z

Perhaps https://www.clojuriststogether.org/?

martinklepsch 2018-07-24T10:13:13.000095Z

@holyjak yes, applied to that 🙂

1🎉
mikeb 2018-07-24T19:19:15.000492Z

@dottedmag Because of a lack of co-ordination, or willingness or interest or whatever by clojure core team(i.e. Cognitect), a multitude of efforts to create clojure documentation has popped up over the years. http://Clojuredocs.org is one such effort. The efforts are valiant, but over the long run it's too much work and cost to ask of any one person. Eventually they fall by the wayside and are neglected and grow out of date.

alexmiller 2018-07-24T19:22:06.000236Z

The core team does maintain a number of doc sites and have written multiple books, so it should be understandable that we are not seeking additional sites to maintain. As you say, it’s a lot of work.

shaunlebron 2018-07-24T19:29:01.000394Z

would there even be overlap between clojuredocs (core) and cljdoc (libs)?

mikeb 2018-07-24T19:33:22.000223Z

@alexmiller Sorry alex, didn't mean to imply that core team should do more than they already do, but that we need more community involvement and focused effort that's sustainable.

alexmiller 2018-07-24T19:34:01.000083Z

Getting people to write good docs is hard :)

alexmiller 2018-07-24T19:34:57.000148Z

There is a spot in the Clojure site guides open to contrib lib docs btw.

alexmiller 2018-07-24T19:35:18.000104Z

Not sure it makes sense to put external docs there

alexmiller 2018-07-24T19:35:46.000464Z

So happy to have things like cljdoc

martinklepsch 2018-07-24T20:47:26.000126Z

> There is a spot in the Clojure site guides open to contrib lib docs btw. > Not sure it makes sense to put external docs there Can you expand on that?

martinklepsch 2018-07-24T20:52:48.000452Z

I would be excited to have “core” link to cljdoc for some libs (maybe start with less popular ones for starters) but I’m not sure if there’s interest in that kind of thing 🙂

alexmiller 2018-07-24T21:11:51.000060Z

The guides page left nav has a subhead for libs

alexmiller 2018-07-24T21:12:08.000188Z

I envisioned this being for contrib guides

alexmiller 2018-07-24T21:12:52.000029Z

But I’m less sure about putting stuff there for non-contrib. But if there was a great place to point, I could do so