Fork me on GitHub

@alexmiller Is the autodoc generator broken again? shows 0.7.4-SNAPSHOT but 0.7.6 is the latest version and 0.7.7-SNAPSHOT should be the API reference version. Does autodoc expect a project.clj file to find the version (because I removed that when I switched the project to deps.edn)?

Alex Miller (Clojure team)17:05:32

the per-project ones are all broken atm

Alex Miller (Clojure team)17:05:50

autodoc works from the pom

Alex Miller (Clojure team)17:05:09

but I can manually regen java.jdbc for you at some point


Yes please. I updated a docstring with an important clarification that I'd like on the docs site!


(when you get a chance -- I don't know how burdensome the regen process is?)


I think someone ran into this on the data xml project as well recently

Alex Miller (Clojure team)18:05:58

@seancorfield it’s harder to remember how to do it than to do it :)

Alex Miller (Clojure team)18:05:10

but I think I made notes last time

Alex Miller (Clojure team)18:05:04

I got like 95% of the way into re-automating it and got pulled away before I could get over the last hurdle or two


I'm curious, what broke it again? I remember it was broken for a while due to something about specs. Then it was working again for a while...

Alex Miller (Clojure team)18:05:30

it was being hosted on a server in Tom Faulhaber’s closet. Then he moved. :)

Alex Miller (Clojure team)18:05:04

that did not seem like a rigorous strategy so I’ve been working on pulling it into the main Clojure CI


where's the fun in that

Alex Miller (Clojure team)18:05:21

I mostly finished that for Clojure itself, although it’s a little bumpy

Alex Miller (Clojure team)18:05:29

anyhow, I just regenerated java.jdbc

Alex Miller (Clojure team)18:05:03

there is still a lot of technical debt around the whole thing, particularly the html gen part. the collection phase is pretty good.

Alex Miller (Clojure team)18:05:03

if I took the time to actually describe it meaningfully, “fixing it” would be a great project for someone


next year's GSoC


maybe not the most interesting but hardly the least useful

Alex Miller (Clojure team)18:05:49

well a) if Clojure applies and is accepted and b) this is a weird mixture of static html gen and devops where having deep knowledge of Clojure is merely helpful and c) it’s all a frightfully boring slog through Someone Else’s Code


Sounds like my day job?

Alex Miller (Clojure team)20:05:31

well if you want to to work on it, let me know :)


Depending on time frame and such, I might just very well be.


Although I’m probably not a GSoC candidate.

Alex Miller (Clojure team)21:05:32

gsoc is irrelevant (to me, at least).


Thank you @alexmiller -- much appreciated!