Fork me on GitHub
#cljdoc
<
2022-05-06
>
lread01:05:30

dev warning: might be a few circleci build failures as I work out some kinks in some ci rework

lread01:05:42

all done!

vemv19:05:49

Is there doc on how to run cljdoc for a private (commercial) project? e.g. run it in CI and create an artifact to be uploaded elsewhere. Similar to "coverage" and "junit" tools

lread19:05:30

Hiya @vemv, are you looking to run the cljdoc web site? Or do you just want to generate the library analysis edn?

đź‘‹ 1
vemv19:05:50

I reckon that I want to generate the "cljdoc web site", but only for the project in question What would the behavior be if I visited / ?

lread19:05:55

Hmm…. so currently cljdoc analyzes a library, saves the result in a database and then the web site dynamically renders from data stored in that database.

đź‘€ 1
lread19:05:58

Tools like https://github.com/weavejester/codox (used by many), https://tomfaulhaber.github.io/autodoc (used by Clojure core team), and the new https://github.com/borkdude/quickdoc (something new from borkdude!) all generate static API docs. Would they be options?

vemv19:05:19

I'm aware of them, but also IDK :) Does cljdoc have internal magic sauce that would make the results more accurate than e.g. codox?

lread19:05:20

The https://github.com/cljdoc/cljdoc-analyzer is a fork of codox. They are pretty similar. Both do load-time analysis to glean public APIs. We currently do a little more (last time I checked) around discovering dynamically created vars for ClojureScript analysis.

đź‘Ť 2
lread19:05:14

Load-time analysis is great in that it will discover everything, but can also be problematic (I mean everything has to actually load correctly). I am currently looking at also supporting static analysis for cljdoc (via clj-kondo data analysis which is what quickdoc uses). But that’s tangental… and not what you were asking about. simple_smile

vemv19:05:28

I really appreciate load-time analysis so yeah I don't know where to take it from here... looks like the ingredients I want are there but not integrated ootb currently

vemv19:05:39

might hack at some point

vemv19:05:53

thanks for all the info!

borkdude20:05:00

codox is pretty great - with quickdoc I wanted something that I could just check into my repo directly and look at straight from Github just as any other .md file in the repo

lread20:05:34

Yeah a lot of folks are very happy with codox. I wouldn’t discount it.