Hacker News new | ask | show | jobs
by derefr 3776 days ago
The "repo landing page" is already handled, somewhat, by GitHub Pages—the idiomatic repo setup is to have a GitHub Pages site "about" your software, linked from the description field of the repo; to link Release downloads directly from the GitHub Pages site, bypassing the repo; and to link to the repo from the GitHub Pages site under a "view source" or "contribute" Call-to-Action. The repo itself, with its README.md, then serves just to document the implementation—setup, usage, release notes, etc.—rather than to describe, explain, or teach you how to use the software.

Speaking of GitHub Pages, this feature complements it perfectly. Now you can create a GitHub-powered website—including images et al—without touching git, in much the same way you'd use one of those "FTP web interface" panels on a VPS. Except that each upload becomes a commit, rather than just mutating some ephemeral folder somewhere.