DimensionalData.jl icon indicating copy to clipboard operation
DimensionalData.jl copied to clipboard

Should we start a changelog?

Open asinghvi17 opened this issue 8 months ago • 8 comments

From some of the feedback in https://github.com/rafaqz/DimensionalData.jl/issues/975 it seems like a changelog requirement could be useful...

asinghvi17 avatar Apr 25 '25 18:04 asinghvi17

Yeah let's. Is there a helper bot for that?

rafaqz avatar Apr 26 '25 11:04 rafaqz

There is a ci that can check for the oatmeal of a changelog

asinghvi17 avatar Apr 27 '25 11:04 asinghvi17

We could adhere to https://keepachangelog.com/en/1.1.0/

That has some good tips on structuring a changelog.

felixcremer avatar May 11 '25 22:05 felixcremer

Its a nice idea It has to be a lot better than this to be worth the effort: https://github.com/rafaqz/DimensionalData.jl/releases/tag/v0.29.16

I'm not totally conviced it will be, it doesn't seem automatable so its directly using dev time

rafaqz avatar May 12 '25 00:05 rafaqz

FWIW, my workflow is to always add a changelog entry when making a PR so that I don't forget it later on when making a release, and I use Changelog.jl for formatting. I think the advantage of a changelog over a list of PRs is that 1) it's easier to communicate breaking changes to users, and 2) you can skip changelog entries for things users don't care about (like improvements to tests or CompatHelper PRs). e.g. here's an example from a package I maintain: https://juliaimgui.github.io/ImGuiDocs.jl/cimgui/stable/changelog/

JamesWrigley avatar Aug 02 '25 16:08 JamesWrigley

Oh, and this is a very handy site :) https://ichard26.github.io/next-pr-number/ I keep bookmarks for each package I maintain so whenever I make a PR I check the site to lookup the PR number for the changelog, saves having to figure it out manually or update the changelog after making the PR.

JamesWrigley avatar Aug 02 '25 16:08 JamesWrigley

@JamesWrigley I addd this in #946, let me know if there could be any improvements to the approach. I realised we really have to write it iteratively in future, its hard to remember or find where something specifically happened 5 months ago and what it broke. But its a start.

rafaqz avatar Aug 15 '25 05:08 rafaqz

Nice, I think that looks good 👍 The only thing I'd suggest is linking it somewhere in the docs?

(sorry for lazily not making a PR already, I've made a couple of attempts to work with vitepress but never got it building locally)

JamesWrigley avatar Aug 17 '25 18:08 JamesWrigley