oh… maybe this is what @U04V70XH6 warned me against? is cljdoc parsing the clj files in my template ?

Thanks for reporting @U017QJZ9M7W! I'll take a peek sometime today.

sounds good! I’ve also gone ahead and changed all of the clj and cljs extensions to tmpl, as @U04V70XH6 suggested in #C019ZQSPYG6. that hopefully will get us set on the next release

maybe something is strange though, since I don’t know if my hooks namespaces in resources get analyzed? https://github.com/mentat-collective/Clerk-Utils/blob/main/resources/clj-kondo.exports/org.mentat/clerk-utils/hooks/mentat/clerk_utils/viewers.clj like this will fail for sure, given my declared dependencies…

I guess I can :no-doc the hooks namespaces? is that required?

Yeah, namespaces with :no-doc are not explicitly loaded during analysis (but note, they can be implicitly loaded, by your other namespaces, probably not the case for you here though). :no-doc a good way to tell cljdoc (and codox for that matter) that a namespace should be excluded from your public API.

Okay, that should cover it… and the tmpl change hopefully will fix the template getting pulled in

It's currently a bit on the heavy side, but https://github.com/cljdoc/cljdoc/blob/master/doc/running-cljdoc-locally-author.adoc if you like.

Lemme me know if there is anything else to look into here, happy to help if there are still mysteries.

Thank you’

!

The hooks can have a .clj-kondo extension as I recall. Check next.jdbc (in at a cat show right now and can't check)

Huh, forgot that @U04V70XH6, but yeah that is what I've done for hooks I've written: https://github.com/clj-commons/etaoin/tree/master/resources/clj-kondo.exports/etaoin/etaoin/etaoin

I took that approach, thanks all!

@lee we have liftoff! https://cljdoc.org/d/org.mentat/clerk-utils/0.4.1/api/mentat

Sweet! Btw, I have not gotten a response from the author of flexmark-java yet about those ref links in images yet.... so they'll continue to render badly for the near term.

no problem, thanks for checking in on that