Fork me on GitHub
Slack Archive

This page is not created by, affiliated with, or supported by Slack Technologies, Inc.

2020-10-20

Channels

#cljdoc
<
2020-10-20
>
rschmukler17:10:15

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

martinklepsch17:10:01

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

rschmukler18:10:16

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>

    <url></url>

    <connection>scm:git:>

    <developerConnection>scm:git:>

    <tag>64952718e6260a8505f078ed70fe8e1001f1f548</tag>

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

martinklepsch18:10:55

can you share a link to the build?

rschmukler18:10:15

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

rschmukler18:10:27

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

martinklepsch18:10:59

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

rschmukler18:10:21

Ahh, that makes sense

martinklepsch18:10:26

the <scm> 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

martinklepsch18:10:43

so that’s why you’re seeing this error

rschmukler18:10:32

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

rschmukler18:10:46

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

rschmukler18:10:24

Hmm it does look to be missing in that link actually

rschmukler18:10:44

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

martinklepsch18:10:46

np & good luck! 🙂

rschmukler19:10:44

Got it working! Thanks again for the help 🙂

martinklepsch12:10:31

Awesome, glad to hear :-)