Right. As always, the “killer” app/lib opens the door. #re-frame is huge but already has great doc.

So you need a killer lib that needs doc.

btw, I have no idea what to do with this:

(str ""
     (:group-id your-project) "/"
     (:artifact-id your-project) "/"
     (:version your-project))

It's how you know the url for the library your looking for

e.g. group-id as "bidi", artifact-id as "bidi" and version as "2.0.3"

I thought it was neat

Where do I get my project’s group-id etc. That looks like mavenspeak or sth. I am on Github, deploy to clojars.

It is mavenspeak in a way. Clojure usually just refers to „projects“. If the name contains a slash the part before it is the group-id the part after is the artifact-id

If there is no slash they are identical

There’s is a small note on this on the current version of http://cljdoc.xyz but I agree that this might be confusing to folks not familiar with maven

I saw the small note but it said nothing about the ids/version coming from Maven/Clojars. I would mention Clojars and Maven. I would even mention lein deloy clojars. I just looked a second time at my Clojars listing and spotted the necessary info. Not sure how I missed it the first time, but it might be because I was not even sure you were talking about Clojars/Maven. hth.

Hmm, 11 minutes and counting on the “download cljdoc code” step. I am prolific, but that seems high. 🙂

Here’s the job: https://circleci.com/gh/martinklepsch/cljdoc-builder/2605

When I reloaded the page the “download code” timer was back at 0. Not sure what happened.

OK, it looks like a different “matrix” got picked up…Oh, jeez, never mind, I put in the wrong group ID… just shoot me

OK, back on track. Getting compilation errors. https://circleci.com/gh/martinklepsch/cljdoc-builder/2608

Wild guess: are .cjlc files supported?

@hiskennyness cljc is supported

@hiskennyness the jar includes a namespace example.spamgen that requires clojure.spec which is not on the classpath

@hiskennyness i think you might be missing the .alpha suffix?

Thx. It occurred to me I have been running off a clone of that code for quite a while now. I’ll get things sorted out and try when I know I have a clean build pushed to cljars. Sorry for the noise.

No worries happy to help troubleshooting. There’s also a document about running cljdoc locally that might be helpful for testing local jars and seeing the result as it will be shown on cljdoc

Ah, great, I was just going to ask if my flailing was running up your CircleCi tab.

Running locally is working great. I see what made we worry about .cljc — the errors complaining about my namespace no conforming to the spec. Anyway, let me get this cleaned up.

Hmm, now the namespace complaint (“Extra input”) is the first error. And the NS looks like this

(ns tiltontec.util.base
  (:require [clojure.string :as $]))

Why is spec running? How can I run spec myself to match what cljdoc is doing? The project dependency is clojure 1.8.0 --- spec is 1.9.0, IIRC.

Yeah, cljdoc currently uses 1.9.0 or higher. Will fix that eventually, not a hard requirement really

But good to support 1.9.0 anyways :P