Fork me on GitHub
#clojure-dev
<
2018-05-09
>
seancorfield17:05:27

@alexmiller Is the autodoc generator broken again? http://clojure.github.io/java.jdbc/ 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

seancorfield17:05:56

Yes please. I updated a docstring with an important clarification that I'd like on the http://clojure.github.io docs site!

seancorfield17:05:27

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

dpsutton18:05:05

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

seancorfield18:05:09

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

bronsa18:05:12

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

bronsa18:05:17

next year's GSoC

bronsa18:05:54

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

slipset20:05:08

Sounds like my day job?

Alex Miller (Clojure team)20:05:31

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

slipset20:05:00

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

slipset20:05:34

Although I’m probably not a GSoC candidate.

Alex Miller (Clojure team)21:05:32

gsoc is irrelevant (to me, at least).

seancorfield21:05:23

Thank you @alexmiller -- much appreciated!