Dear OSS community on Mastodon,

Every day I scroll through my feed and I see proud announcements like:

“First Alpha Relase of HyperTurboWidget available"

or

“Version 2.7.1 now with improved glorb handlers!”

or

“Flux Capacitor version 4.5 is out”

… and I sit there wondering if I should be excited, terrified, or calling a licensed electrician.

Don’t get me wrong, I love open source. I just have no idea what three quarters of these projects actually do. Are we talking about a web server? A file system? A middleware thingy that keeps the flux from overflowing into the space–time continuum?

So, dear OSS developers of the world: When you announce a new release, please give us (your adoring but slightly confused audience) just a tiny bit of context.

• Tell us what your software does.
• Tell us why this release is cool.
• Tell us what it requires to work.

Example:

We are proud to announce Flux Capacitor version 4.5 is now avalaible. While it creates a nice wormhole to 1955, it requires an underlying gigawatt stack 1.21 to work reliably.

Because nobody wants to cheer enthusiastically for “v2.7.1” while secretly Googling “what is a glorb and why does it need handling”.

Yours truly,

Someone who wants to celebrate your achievements