For sure, I don't mean to blanket all FOSS projects under the same observation. But I've seen some projects where the idea is brilliant, and it fills a gap that no other software can, but they have piss-poor instructions (or none at all) and hardly describe what the project is or does. You only learn about them by chance, which is a real shame.

Here's another example: Navidrome (https://www.navidrome.org/) is an awesome, self-hosted music streaming software.

But their homepage doesn't have a screenshot, so you have no idea if the UI is just command prompt, ugly, unintuitive, or the best thing ever. Even the "learn more" page has no screenshots unless you really go digging.

Compare that to another FOSS self-hosted music streamer: https://ampache.org/

Simple website, but at least you can see exactly what to expect from the UI. Huge advantage even if they two apps do the exact same thing (both based on the Subsonic backend).