Fork me on GitHub
#clojars
<
2016-03-04
>
adamfrey20:03:19

has anyone ever discussed having generated documentation pages from the Clojure libraries hosted on Clojars?

adamfrey20:03:41

so, a library creator could push up a library that has docstrings for all the functions and get hosted documentation automatically? IMO that would be a huge and standardized benefit to the Clojure community. I understand it would be a fair amount of work.

adamfrey20:03:11

as an example, the elm packages site: http://package.elm-lang.org/

arrdem22:03:03

Grimoire internally has a documentation engine capable of this, but I've never taken the next step of generating docs on jar push.

arrdem22:03:36

This actually came up on my ideas list a few days ago. The only infrastructure I'd need is a way to get artifact coordinates when they're pushed.

arrdem22:03:15

A short shell script wrapping https://github.com/clojure-grimoire/lein-grim would probably be all you needed beyond such a webhook.