cljdoc 2022-04-10

totally understand if you haven't had time to look

I just tried a minute ago @corasaurus-hex and it works!

but I'm sitting down to code and thought I'd do some housework

sweet!

Please do merge away!

merges

merged! 💜

1

totally an aside but I just noticed we don't have a changelog

maybe that ship has sailed

Yeah true. I’m ok with commit log for cljdoc… but it doesn’t exactly let our users know what’s new and noteworthy.

linking the PRs in the changelog is super helpful, too. you can get context on each change

@pez does that on calva and it's been really helpful for going back through changes to understand context

maybe when we have time

¯\(ツ)/¯

or maybe next PR!

Since we release on merge to master, we’d need something/someone to encourage a changelog is actually updated.

By our ragtag team!

For bigger features the ADRs help with rationales. (but again for devs, not for end users).

🥳

Our ragtag mascot? simple_smile

Yeah maybe not for that changelog…(?) we link to a https://github.com/cljdoc/cljdoc/blob/master/doc/roadmap.adoc#new-storage-backend from http://cljdoc.org and well… it is pretty out of date. I expect the same would happen with a changelog. Maybe.