[amelius]

Offtopic. Why, in github, is the README always below the repository files, if the first thing you want to read about a project is the README?

Edit: Could we take the convention on HN to always link to the README in a github repo? In this case that would be:

https://github.com/aosabook/500lines/blob/master/README.md

[ams6110]

Well, it's the first thing you want to read about the first time you visit the project. The rest of the time it's probably the last thing you are interested in.

[marssaxman]

I considered Github links to be essentially content-free noise for several years because I did not know about their "README.md" convention. I think that people who live and breathe github probably don't realize how confusing their interface can be to a newcomer.

[mjrbrennan]

You didn't think to just scroll down?

[marssaxman]

I didn't know to scroll to the bottom, as I had never used github and was unfamiliar with its interface. I thought it was basically just a prettier version of the classic auto-generated "index" page for a directory, so it didn't occur to me that there would be more to it than the file list if I scrolled down.

[pc86]

> I didn't know to scroll to the bottom

If only there was some sort of bar that could indicate your relative position on the page. Maybe in the same spot on all websites to make it easy to see. Maybe even part of the browser!

In all seriousness this seems much less a GitHub issue and much more about how well you computers.

[marssaxman]

It is an issue of expectations and affordances. If there's no clue that what's at the bottom is going to be different than what's at the top, and what you're seeing at the top is not giving you anything useful, why would you scroll further and waste your time seeing more of it? Perhaps for some people that is natural, but different people navigate unfamiliar spaces in different ways.

What you see when you open a github project page is a file directory. If you have no pre-existing reason to believe the page is something more than it appears to be, it's reasonable to believe that the page you're looking at is, in fact, just a file directory. There is nothing on the page which suggests that it also contains a readme file viewer, hidden underneath.

I didn't scroll because the directory structure suggested to me that one would navigate by digging around to see what was inside. After the first couple of times I tried this without getting anywhere, I wrote github off as a waste of time, and after that I simply closed such links immediately. It might have been easier to discover README.md from some later link with a smaller directory, where a smaller amount of scrolling down might have revealed it, but by then I was no longer looking.

[wagglycocks]

But ... why would I assume that the bottom of the page had meaning when the top did not?

You don't read all the way through the Time Cube page before coming to an idea about the contents.

[StefanHamminga]

.repository-content { display: flex; flex-direction: column; }

#readme { order: -1; }

You could add that to the page style (using a browser plugin).