> That is not the first file people looking at. Especially not people looking > at the GitHub copy: > > https://github.com/postgres/postgres > > I understand that there is documentation, but for the casual developer > looking at this, it seems broken.
FWIW, I think that people depend too much on github and what github thinks projects should do to be more presentable, like adding a markdown-style README or such.
If you push a README.md file formatted in Markdown, github/gitlab will show it instead of README.
That's the way it is done in PostGIS, showing badges and stuff for github only: