cljdoc

https://cljdoc.org/ & https://github.com/cljdoc/cljdoc
rschmukler 2020-10-20T17:26:15.100Z

Heyo! I'm trying to get a project that has submodules to export documentation correctly. The project is https://github.com/teknql/wing/ and I have a :cljdoc/include-namespaces-from-dependencies key in my cljdoc.edn . I saw it work correctly with a snapshot release (https://cljdoc.org/d/wing/wing/0.0.1-SNAPSHOT/doc/readme) but upon switching to the 0.1.0 release it seems to not include them. As far as I can tell, that's the only thing that changed... Also worth noting that the root namespace does not export any namespaces itself, instead it is composed entirely of its submodules. Any help would be hugely appreciated. Also, here's a link to the current docs: https://cljdoc.org/d/wing/wing/0.1.0/doc/readme

martinklepsch 2020-10-21T12:41:31.103700Z

Awesome, glad to hear :-)

martinklepsch 2020-10-20T17:44:01.100300Z

did you check the documentation pages for the individual submodules? if the build for one of them fails then it’s namespaces can not be shown for the “parent” module as well

rschmukler 2020-10-20T18:50:16.100500Z

Hey! Thanks for the idea. I was able to confirm that a few of them weren't building correctly. Now I'm getting an error about SCM being incorrectly set, but I just confirmed that the pom.xml was correctly generated and http://clojars.org was able to import it fine... SCM in pom.xml for reference:

<scm>

    &lt;url&gt;<https://github.com/teknql/wing>&lt;/url&gt;

    &lt;connection&gt;scm:git:<git://github.com/teknql/wing.git&lt;/connection>&gt;

    &lt;developerConnection&gt;scm:git:<ssh://git@github.com/teknql/wing.git&lt;/developerConnection>&gt;

    &lt;tag&gt;64952718e6260a8505f078ed70fe8e1001f1f548&lt;/tag&gt;

  &lt;/scm&gt;
This isn't different than other versions that had imported successfully... Also, rerunning the job doesn't seem to help

martinklepsch 2020-10-20T18:50:55.100700Z

can you share a link to the build?

rschmukler 2020-10-20T18:51:15.100900Z

Also interesting is that the 0.1.0 docs now have the missing submodules despite not republishing? https://cljdoc.org/d/wing/wing/0.1.0/doc/readme

rschmukler 2020-10-20T18:51:27.101200Z

(missing namespaces from the broken libs, but have some)

rschmukler 2020-10-20T18:51:41.101400Z

https://cljdoc.org/builds/36212

martinklepsch 2020-10-20T18:51:59.101600Z

yeah, the include-namespaces-from-dependencies works at the cljdoc database level and doesn’t necessarily require a rebuild of the parent lib

rschmukler 2020-10-20T18:53:21.101800Z

Ahh, that makes sense

martinklepsch 2020-10-20T18:53:26.102Z

the &lt;scm&gt; of this POM does not include a revision/tag like the snippet you added above: https://repo.clojars.org/wing/wing/0.1.2/wing-0.1.2.pom

martinklepsch 2020-10-20T18:53:43.102200Z

so that’s why you’re seeing this error

rschmukler 2020-10-20T18:54:32.102400Z

That's interesting - wondering if that's a bug with clojars

rschmukler 2020-10-20T18:54:46.102600Z

https://clojars.org/wing - if you look there, you can see the "published with this commit" which also uses the tag?

rschmukler 2020-10-20T18:55:24.102900Z

Hmm it does look to be missing in that link actually

rschmukler 2020-10-20T18:55:44.103100Z

Alright, gotta see what's going on w/ the pom.xml then. Thanks for the help

martinklepsch 2020-10-20T18:56:46.103300Z

np & good luck! 🙂

rschmukler 2020-10-20T19:26:44.103500Z

Got it working! Thanks again for the help 🙂