Redesigning GitHub Repository Page

Re:Redesigning GitHub Repository Page by wyattpeak on Thursday February 28, 2019 @07:59PM (#19277052)

That seems like a great idea in principle, but for most small projects the GitHub page /is/ the documentation. If that weren't the case, you wouldn't see half a dozen links to GitHub pages to show off projects on HN each day.

It's all very well to talk about ideals, but you can't ignore reality in the process.

You're right, though, that you shouldn't have to scroll past it every time. I don't really know what the solution is, but having it there but going undiscovered is the worst of both worlds.

[ Parent | on HN ]

Re:Redesigning GitHub Repository Page by X-Istence on Thursday February 28, 2019 @08:18PM (#19277152)

If you've read one README on Github, you know to scroll down to see it on every other project. I would argue that it's not a steep learning curve, and it's not like the hide the scrollbar... we scroll in other websites without issue when we are looking for content, especially with ads being most of the content above the fold these days.

[ Parent | on HN ]

Re:Redesigning GitHub Repository Page by wyattpeak on Thursday February 28, 2019 @10:13PM (#19277648)

I agree it's not much of a learning curve, but neither is learning which icon represents a commit. This entire discussion is about minor details.

[ Parent | on HN ]

Re:Redesigning GitHub Repository Page by DanSmooth on Saturday March 02, 2019 @03:19PM (#19290979)

A small "Read the full description"-link to the #readme anchor below the inital short description probably would work wonders here.

[ Parent | on HN ]