cljdoc

lread 2022-09-05T21:17:53.211369Z

Ok. I think it is finally time someone implement the feature to allow updating cljdoc docs after a release. I volunteer. The last time we talked about this we figured a cljdoc/<version> tag would work. See point 8 of https://github.com/cljdoc/cljdoc/issues/459 - reiterated/validated here in https://github.com/cljdoc/cljdoc/issues/31#issuecomment-1177929806. đŸ§”

đŸ˜» 1
lread 2022-09-05T21:21:22.816209Z

Thoughts?: We could apply this to articles only, or do a full rebuild (analysis and articles) or some other variant.

lread 2022-09-05T21:23:51.623539Z

Use cases are: 1) I want to update something like a :git/sha in my README. 2) I’ve noticed I made a mistake in my docs and want to fix without releasing a new jar. 3) ?

lread 2022-09-05T21:31:48.242209Z

The articles only path might be nice if you’ve made a bunch of code changes on master but you’d like to correct a mistake in your articles on cljdoc for your last release. Articles only would also avoid the issue of jar-sources vs git-sources mis-matches.

lread 2022-09-05T21:35:58.724609Z

Actually I think https://github.com/cljdoc/cljdoc/issues/31 doesn’t talk about docstrings much. And its title sez “Updating Articles after a release” so maybe that’s all folks want?

lread 2022-09-05T21:37:55.189489Z

Pinging those who’ve had an interest in the past: @seancorfield, @suskeyhose

2022-09-05T22:17:08.940389Z

Articles are the main point for me at least. The readme is the primary thing I want to update, and this allows adding new articles as tutorials without a new release.

lread 2022-09-05T22:36:11.854279Z

Thanks @suskeyhose!

seancorfield 2022-09-05T22:53:11.365219Z

Also me. I would want to regen the articles (including README, CHANGELOG) but not re-run source analysis. In particular, docstrings should stay in sync with released code since they pop up in editors and should agree with what's (already) on cljdoc.

lread 2022-09-05T22:53:56.456709Z

Good point about docstrings @seancorfield, thanks!