People have come to expect a repository's source code to guide them through the contribution process. That job belongs to documentation and developer guides.
Comments are for the people writing the code, not necessarily the peanut gallery. If a readme was meant as a sales pitch, it would be a website or a blog post.
Is GitHub's UI too friendly?#ThoughtsWelcomePeople seem to expect source code to introduce them to the project, instead of simply making the program run.Blog...