Fork me on GitHub
#cljdoc
<
2019-09-11
>
teodorlu14:09:46

Hello! Newbie question #1. I'm updating my Git-repo and pushing new SNAPSHOT-releases to clojars, but my docs aren't updating. Can I tell cljdoc to regenerate docs based on master and latest SNAPSHOT in Clojars? Project: https://cljdoc.org/d/org.clojars.teodorlu/duct-unofficial-docs/0.2.2-SNAPSHOT/api/duct-unofficial-docs.core

teodorlu14:09:41

Newbie question #2. I'm trying to bring in namespace docs from dependencies (duct/core and metosin/reitit), but I don't get any docs for namespaces from foregin artefacts (project link above). Any suggestions welcome!

teodorlu14:09:10

And thanks for a great project! I really think cljdoc will be valuable to the Clojure ecosystem long term.

martinklepsch14:09:11

@teodorlu SNAPSHOT versions aren’t built automatically, you can initiate a rebuild that will (potentially—subject to caching) use an updated SNAPSHOT. To do so find the hidden rebuild button left of the GitHub link in the top right corner and click it 🙂

teodorlu14:09:40

Ooh, I'll have a look

teodorlu14:09:12

Found the button 😄

teodorlu14:09:16

Rebuild worked perfectly, thanks!

martinklepsch14:09:39

As for #2 I’m not completely sure why that isn’t working, I think what you’re doing looks right

martinklepsch14:09:29

Found this in the relevant code but that shouldn’t affect the basics I think > Note: When rendering namespaces we ultimately need some information about the backing Git repository to create proper source links. For now this is only supported if the modules included via dependency-version-entitiesare backed by the same Git repository as the primary artifact.

teodorlu14:09:33

Thanks for having a look. Pushed to Clojars for the first time today, so it's probably something on my part.

martinklepsch14:09:28

Cool, keep me posted and feel free to open an issue if the problem persists.

martinklepsch14:09:57

If you want to play around with cljdoc locally, there’s some documentation on that: https://github.com/cljdoc/cljdoc/blob/master/doc/running-cljdoc-locally.md

teodorlu14:09:58

Thanks for the help! And for the pointer for the other question.

martinklepsch14:09:19

No problem 🙂

nha22:09:56

If my library is there: https://cljdoc.org/d/com.turtlequeue/clj-client/0.0.7 should I be able to get a badge? https://cljdoc.org/badge/com.turtlequeue/clj-client/0.0.7 Also I noticed it does not appear in the search EDIT: commented there about the search https://github.com/cljdoc/cljdoc/issues/308#issuecomment-530584697