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. đ§”
Thoughts?: We could apply this to articles only, or do a full rebuild (analysis and articles) or some other variant.
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) ?
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.
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?
Pinging those whoâve had an interest in the past: @seancorfield, @suskeyhose
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.
Thanks @suskeyhose!
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.
Good point about docstrings @seancorfield, thanks!