I'm on GitHub hours a day. Many things on there are libraries or tools. In those cases 90% of the people who come to the page just want to USE the code, not read it.
I see a lot of developers in that 90% get really confused because the README is below the fold. You're immediately presented with a directory structure that you don't care about.
I'd almost like to see different views for different purposes. Not sure what the answer is.
At work I made firebaseopensource.com to sort of re-skin GitHub with an emphasis on the docs, not the code. GitHub Pages is often used the same way.
I see a lot of developers in that 90% get really confused because the README is below the fold. You're immediately presented with a directory structure that you don't care about.
I'd almost like to see different views for different purposes. Not sure what the answer is.
At work I made firebaseopensource.com to sort of re-skin GitHub with an emphasis on the docs, not the code. GitHub Pages is often used the same way.