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:…
Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
51–60 of 127 posts
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#52The 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…
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#53Earlier quoted context omitted.
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.
This is about app store changelogs, not commit messages
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#54It also allows app developers to bucket users in groups and A/B test experiments on users to see what works best. It would not be uncommon for the larger players (Microsoft, Google, Facebook, Pinterest, Uber, Spotify, etc) to have 100s or 1000s of experiments running concurrently. It also decouples rolling out features from App Store releases.
Having said that, I also hate generic changelog messages and not defending the practice. If new features are to be launched with the build, write it in the changelog and add "(rolling out)" or "(coming soon)" next to it.
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#55Earlier quoted context omitted.
This is about app store changelogs, not commit messages
I have never understood "it's an app store" precludes an expander or link to details.
+ Customers will often have no understanding of what you're saying, but still click the link and give low reviews for it's content.
+ More stuff the the app store review team to refuse publishing an update for.
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#56Most general users of apps on phones wouldn't give an absolute crap if you "fixed a buffer overrun in the X function", because that means nothing to them. If they read that you've made performance improvements, then great they can continue to play Candy Crush but not have it crash so often. They won't CARE that you "optimised the use of the strcopy function" or some crap like that.
Remember the app stores are targeted towards consumer users of phones, not tech people that live on Hacker News websites.
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#57Sounds like the screen shot he took in September really was a bugfixes and performance release.
So it sounds like these apps (at least, WhatsApp) follow a wise policy - tell the users what has changed that matters and don't drown them in irrelevant information.
I had the same policy for my teams - tell users 4-5 new features/changes to workflow they are going to see and for g-d's sakes, do not drown that out by listing 400 irrelevant infrastructural changes we happen to be pushing out.
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#58Just like when I see “50% less sugar”, I immediately assume they replaced sugar with chemicals.
Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#59Re: Lets talk about changelogs (how I loathe 'bugfixes and performance improvements)
#60The 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'd try to change what you wrote to something like:
"Fixed out-of-memory errors on some 32-bit systems"
"Improved startup time for configurations with lots of items"
This makes it easy to gauge if this update is important to get installed ASAP, such as fixing something they've experienced or are likely to experience.
Grouping "several UI fixes" or "performance improvements" is usually fine, but I tend to call out something like "fixed UI bug where a network error could result in changes not being saved with no warning" or an issue that a sizable chunk of users had reported.
Doing this well takes time, though, as you have to synthesize the internal ticket summaries, PRs and/or commit messages and reword almost everything. This is understandable for open source or free/indie apps, but for subscription/"enterprise" software it's definitely one of the differences between "great" and merely acceptable (or worse).