no joke I think the single most effective effort-to-result change that The Tech Internet could make for usability is to move the github readme above the github file list
@0xabad1dea I think this is one of those things where different classes of user want polar opposites. My suggestion would be that if you’re a contributor to repo, readme down bottom, you’re probably here for code. If you’re not, up top, you probably want some context.
@jon if you’re a contributor to the repo why would you be constantly mucking about in the online file preview instead of your local copy
@jon @0xabad1dea I mean I'd rather have the readme at the top of my own repos, which are almost exclusively solely used by me, because I have a bad habit of updating the project but not the readme and if it was more prominent I'd likely notice discrepancies
@jon @0xabad1dea
Who says they need to be on the same page at all? Put the readme on some kind of landing page and the files on a .../repo or something. Contributers will bookmark .../repo, problem solved.
@jackeric @jon @0xabad1dea I always write my READMEs (for personal stuff) from the perspective of "other people are going to use this". As far as I know, this has *never* happened
@0xabad1dea I do it quite a lot for the purposes of sending links to specific chunks of code to people. Stuff like “oh, that’s implemented here”.
@0xabad1dea @jon Not constantly, but I do use it every so often to share a link to coworkers, or to quickly look up how the code looks on a particular branch (not as a diff). Nothing that can’t be fixed by tapping the End key though. Or the readme can be collapsed by default on repos you have push access to.