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
Awesome, glad to hear :-)
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
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><https://github.com/teknql/wing></url>
<connection>scm:git:<git://github.com/teknql/wing.git</connection>>
<developerConnection>scm:git:<ssh://git@github.com/teknql/wing.git</developerConnection>>
<tag>64952718e6260a8505f078ed70fe8e1001f1f548</tag>
</scm>
This isn't different than other versions that had imported successfully... Also, rerunning the job doesn't seem to helpcan you share a link to the build?
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
(missing namespaces from the broken libs, but have some)
yeah, the include-namespaces-from-dependencies
works at the cljdoc database level and doesn’t necessarily require a rebuild of the parent lib
Ahh, that makes sense
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
so that’s why you’re seeing this error
That's interesting - wondering if that's a bug with clojars
https://clojars.org/wing - if you look there, you can see the "published with this commit" which also uses the tag?
Hmm it does look to be missing in that link actually
Alright, gotta see what's going on w/ the pom.xml then. Thanks for the help
np & good luck! 🙂
Got it working! Thanks again for the help 🙂