[billrobertson42]

When you're writing a release, or about some detail of your project, you need to directly give new readers background, or at least provide some navigation to something else that provides background.

A lot of tech and tech-adjacent writing is like that these days. Our cool project X now does Y! With no introduction about what X is, or even a link to something that describes it. So most readers are left to wonder about why should care. At times, I've even tracked down X's github repo only to find that their README has the same problem.

It's an easy trap to fall in when you write. It's easy to feel like you're over-explaining things. You, the author, know what it is, and likely many of the people who follow X know too. The problem comes when some curious person outside of the Xosphere takes a look. Chances are good you'll lose most, if not all, of them.

If you want people to be interested in your X, then make sure they have a way of learning about your X when you introduce improvement Y.