3 ms·
I disagree. Users, not just maintainers, discover projects through GitHub. In this context, the README effectively serves as a secondary project landing page. I
by simonklitj 3y ago
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.
- dylan604 3y agoThen a link to the website which is a much better medium for demonstrating software than README files would be a simple fix.
- prepend 3y agoThen 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.
- otterley 3y agoThe 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.
- prepend 3y agoIt’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.