Hacker News new | past | comments | ask | show | jobs | submit login

> Maybe they are trying to push towards using badges/shields inside the README

If they're pushing for that, then keeping the README below the file list seems counterproductive.




I’d second this. In fact, I think the README should be the first thing (potentially in collapsible form so you can easily see the file list without scrolling too much).

Intuitively, I’d bet most people landing on the front page of a repo are consumers of the library looking for a README with info on how to get started or where to look for information on how to get started. Again, this is only intuition—no data to back it up. Project maintainers are most likely interacting with the issues and PR sections or code on the command line.


I personally liked this change. Even if it is the MS MO embrace extend extinguish.

If I want to read your readme ill click on your readme. If im visiting your github page I want to read your code.

Eee, theyre downplaying the focus on cross platform friendly md files showing repo info, instead they want you to use the newly more prominent side bar that is wholy only available on github.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: