Minor quibble, but I share your concern. It is more of a developer choice rather than a github limitation. github supports pod format, README, and I have no idea what else, displayed on the front page of a project. You can also supply a link to a project page. But what do I expect? Same as you -- main feature description, screenshots (please), and additional links to documentation and examples.