---
title: "Don't Be One of Them"
description: "Eleven of the twelve pending app updates on my phone tell me nothing about what changed. Your release notes can do better."
pubDate: 2026-10-17
canonical: "https://preview298.sjg.io/writing/dont-be-one-of-them/"
---

# Don't Be One of Them

Of the 12 pending app updates on my phone right now, 11 have release notes like this.

![Version history repeating "Bug fixes and performance improvements" across six releases.](/images/app-release-notes.webp)

"Bug fixes and small improvements."

Repeated. Every version. For months.

Which bugs? What improvements? Did you fix the thing that's been annoying me, or have you just moved the buttons again?

I'm not asking for your commit history. Give me a couple of sentences about what changed and why I should care.

You did the work. Tell me what you did.

Don't be one of them.