Live data from Hacker News

Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

raymii.org

11–20 of 127 posts

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#11
post #5

The reason these bigger apps just put "Bugfixes" and "Performance Improvements" in their changelog is because when you have many teams contributing to the software not only through actual code editing but also feature flagging what features go out on what release, rollback policies etc this becomes a nightmare to fill in. Doubly so when different users are receiving different experiences. The article says at the end:…

It is bugfixes or performance improvements about things that exist, though.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#12

The problem is often the "bugfixes and performance improvements" are a list of 60 things, and for almost all users "there are less crashes and it is faster" is all they would want to know. How many users want to read (OK, possibly people here) "On some versions of glibc, the 32-bit specialisation of memcpy which used SSE2 instructions had a bug when the memory being copied crossed the 2GB boundary, so in that case we…

A lot of people here would like this level of detail, actually. But general apps are intended for the general population, which is why big orgs go for the minimum watered down version. It's more work and overhead if they confuse their users.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#13

I automate the app deployments for our team and “bugfixes and performance improvements” is the changelog because it’s totally automated on release. Yes the automation could grab something from the commit logs but I’m not confident I’d want to expose some of our commit messages. Also recent versions of iOS have further hidden away the update ui making it very hard to find for most users, so why bother taking the time…

You can maintain a file with the current/next changelog in your vcs and pull from that. Works with automation, but is still curated.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#14
post #5

The reason these bigger apps just put "Bugfixes" and "Performance Improvements" in their changelog is because when you have many teams contributing to the software not only through actual code editing but also feature flagging what features go out on what release, rollback policies etc this becomes a nightmare to fill in. Doubly so when different users are receiving different experiences. The article says at the end:…

>The article says at the end: "You see? Not that hard right?". It is that hard in bigger organisations.

The size of the organisations is not important, as is the size of the team working on the particular feature/app.

Apple is huge, for example, but eg. Logic Pro has great changelogs.

We also see huge apps (with large teams) do better than than small apps (with much smaller teams). It's more about bothering/caring than difficulty.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#15
As with many others here no doubt, I spent a lot of time in 2020 viewing diffs between library versions, reading changelogs, and tracking upstream bugs/features.

Although I'll try to resist going on too much of a pro-FOSS rant, the change audit process is much easier for open source projects since you can read not just the changelog entries, but also the corresponding code to verify the claims.

That helps with various things including developer trust - it helps you determine whether a project and authors use test coverage to reproduce bugs and prove their fixes, whether performance improvements are measurable, whether there are risky side-effects to look out for, and so on.

Increasingly I think that these kinds of 'software due diligence' should become part of recommended software engineering workflows, and that makes me wonder whether some of the repetitive aspects can be automated.

A genuinely user-focused, trustworthy app ecosystem would, I think, allow some of these 'change audit' processes to be visible to users so that they can make informed upgrade decisions, and to create a marketplace incentive for upgrades to be reliable.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#17

In an "app store" context, the apps don't serve you; you just generate content/engagement for them. The apps you're looking at don't WANT you to be informed because you might choose not to use them. These notes are just a formality standing in for forced automatic updates. Spotify on Google Play is particularly insulting. They basically tell/shame you that you should just always update without caring about the change…

>In an "app store" context, the apps don't serve you; you just generate content/engagement for them.

This is a non-sequitur.

There are all kinds of apps in an "app store" context, and the apps I use serve me very well, thank you. I also don't generate any "content/engagement" for any of them.

Whether apps have good changelogs or not is also not a factor of whether the apps are in an app store or not.

You maybe meant to say "social apps" as opposed to "app store" apps.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#18

The problem is often the "bugfixes and performance improvements" are a list of 60 things, and for almost all users "there are less crashes and it is faster" is all they would want to know. How many users want to read (OK, possibly people here) "On some versions of glibc, the 32-bit specialisation of memcpy which used SSE2 instructions had a bug when the memory being copied crossed the 2GB boundary, so in that case we…

I prefer the detail. You could always make the first line: “bug fixes and performance improvements” with details following. Then people who don’t care can ignore the details, but people who do care can get an understanding of what the change is about.

Deep understanding of a change is really helpful when looking through history or trying to make sense of why this particular line was changed, etc.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#19

The problem is often the "bugfixes and performance improvements" are a list of 60 things, and for almost all users "there are less crashes and it is faster" is all they would want to know. How many users want to read (OK, possibly people here) "On some versions of glibc, the 32-bit specialisation of memcpy which used SSE2 instructions had a bug when the memory being copied crossed the 2GB boundary, so in that case we…

There’s also a mitigating liability aspect to this. If you start providing minutiae detail, you may start revealing pretty big faults that have escaped to prod. People question the safety of your product and now you’re open to lawsuit or at least micromanaged by some unforgiving end-customers. To cope, you start to not fix certain problems so you won’t have to report the bugs or you start lying what the bugs were. I’m not so sure it’s on net a useful direction to be quite that open.

Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)

#20
The worst of these is the "Google" app. For over a year, every single new version has the exact same four-entry changelog, which translating from Portuguese is something like: "enhanced search page appearance; new doodles designed for app experience; off-line voice actions, available only in the USA; web pages opened directly within the app". I have the slight suspicion that most of the almost weekly updates to the "Google" app do not have these four changes... for that app, "bugfixes and performance improvements" would actually be a better (more correct) changelog.
Post reply on HN