[andrewbinstock]

By far the biggest thing I wish github would do is change the text entry beside the file names. Right now, it shows the comment of the last push of edits to that file. That's great for members of the project.

However, for non-members it would be far more useful to know what the file is. Here, enabling a one-line description would be hugely helpful.

Since GH knows if you're a member of the project it can show you the right text--description or latest update. And presumably, a button would allow you to see the other text if you needed it.

[hyperion2010]

If you don't know where to look it can take a surprisingly long time to find things like: https://github.com/torvalds/linux/blob/master/Documentation/.... It is obvious once you know, but unless you know are in the habit of checking all the 'likely places' such a doc would be you are going to be lost. While one could allow annotations on top of files in github it would completely fragment real and important documentation efforts and leave information scattered in 10 different locations that no one could pull back together.