Sorry, but one screenshot would be enough to demonstrate what the repository is about.

So many project fail at this.

The website has more than one.

When quickly browsing github projects to see what's worth my time I don't always click the website link.

I likely skip over repos with no screenshot much more.

What purpose are you browsing projects on github? Genuine question, as I've never done this.

To find active popular open source projects?

How do you do it?

Word of mouth, organic exposure. I've only used github search only for a few time aside from quickly finding one of my repositories.

Typically github readme's are targeted at busy developers rather than beginner s as well.

They also include a contributor guide so I can see how hackable some project I'm using is.

I also prefer to use projects I wouldn't hate hacking on if forced to. So a PHP project has a much higher bar than aHaskell project.

Github and other forges easily allow this approach.

I don't actively try to find active open source project, usually I stumble onto plenty of them from natural browsing/research for my own work

That's why I was asking, why would you actively search for projects? To consider contributing or just out of curiosity?

love to see what your project repo looks like as a comparison.

I disagree. Users, not just maintainers, discover projects through GitHub. In this context, the README effectively serves as a secondary project landing page. IMO, for a visual project like this, images, or a direct link to images, is a must.

Then a link to the website which is a much better medium for demonstrating software than README files would be a simple fix.

Then a link to an example image on the web site is much better.

The idea is to help people understand the project. Not to give them an investigation task. I don’t know the structure of that web site or if there are even images there.

The first time in your life that you learn that a project's code lives on GitHub and its documentation and marketing website are someplace else, you'll start looking for the website reference in the GitHub README or searching for it as a matter of course. It's really not that big a deal.

It’s not a big deal. It’s just a useful piece of documentation.

I’m not heartbroken because of this gap, I’m just confused why they wouldn’t want to add these docs to help users.