cljdoc

Cora (she/her) 2022-04-10T19:25:46.268929Z

@lee how are you feeling about https://github.com/cljdoc/cljdoc/pull/575 ?

Cora (she/her) 2022-04-10T19:26:09.033009Z

totally understand if you haven't had time to look

lread 2022-04-10T19:26:22.756759Z

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

Cora (she/her) 2022-04-10T19:26:26.955849Z

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

Cora (she/her) 2022-04-10T19:26:29.210129Z

sweet!

lread 2022-04-10T19:26:29.916879Z

Please do merge away!

Cora (she/her) 2022-04-10T19:26:31.916569Z

merges

lread 2022-04-10T19:26:41.922309Z

gratitude

Cora (she/her) 2022-04-10T19:26:49.300489Z

merged! 💜

1
Cora (she/her) 2022-04-10T19:27:23.850589Z

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

Cora (she/her) 2022-04-10T19:27:28.133509Z

maybe that ship has sailed

lread 2022-04-10T19:29:01.834399Z

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

Cora (she/her) 2022-04-10T19:29:55.780799Z

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

Cora (she/her) 2022-04-10T19:30:36.762899Z

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

Cora (she/her) 2022-04-10T19:30:52.324649Z

maybe when we have time

Cora (she/her) 2022-04-10T19:30:53.940729Z

¯\(ツ)/¯

Cora (she/her) 2022-04-10T19:30:58.319869Z

or maybe next PR!

lread 2022-04-10T19:38:46.815809Z

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

lread 2022-04-10T19:38:58.117739Z

By our ragtag team!

lread 2022-04-10T19:40:16.613989Z

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

Cora (she/her) 2022-04-10T19:40:22.531909Z

🥳

lread 2022-04-10T19:40:54.645509Z

Our ragtag mascot? simple_smile

Cora (she/her) 2022-04-10T19:47:26.041509Z

haa

lread 2022-04-10T20:05:26.236989Z

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.