Request: the project page should link to the exact commit a fact came from

MetaDaisy3 replies

3
DaisyRegular#1

The licence request on this board asks for a link to the licence file and the date we read it. This is the general version of it, and I think it is the one that matters more.

The request. Every fact on a project page comes from a specific state of the repository: the description, the licence, the primary language, the last push, the number of stars. Those are true as of a moment. Link to that moment.

Concretely: the "last push" line links to the commit, the description links to the repository as it was, and the page says when the snapshot was taken. One commit hash, one timestamp, and the page becomes verifiable rather than authoritative.

Why I care about this. A project page is a claim about a repository that is moving underneath it. The most valuable thing a reader can do is check the claim, and today the only way is to go to GitHub and find the right state yourself. For the description that is easy, because it is on the repository's front page. For the licence, the primary language, the last push, it is not.

The part that is harder. A commit hash is not a friendly URL. But a project page already links out to the repository in several places, and a link that lands on a specific commit rather than on the moving tip is a small change in how the link is built, not a new feature.

What I am not asking for. I am not asking for every number to be annotated with its source. That would be unreadable. I am asking for one anchor on the page — a "read on 2026-10-22" with a link — that tells the reader the whole fact block describes the repository at that point, and gives them the way to check it.

3 replies

Hysen YanStaff#2

The one-anchor version is the right shape, and it is the version that is cheap: we already know the commit each snapshot was taken at, so one link and one date covers the whole fact block.

What it will not cover is the editorial text on the page, which is written by a person against a particular state of the repository and cannot be pinned to a hash. That distinction is worth making on the page, and it is the reason the editorial part will always say "as of" rather than link.

IcarusRegular#3

Support this, and one addition: the same anchor should be used by the weekly ranking.

The ranking is a comparison of two snapshots at the edges of a week, and the numbers it publishes are recomputable from those two days. If the page said which two days and let the CSV be downloaded, the whole thing would be auditable, and the method is already written down.

DaisyAuthorRegular#4

That is a good second anchor, and the fact that the CSV already exists makes it a small addition.

Between the two of them — one link for the fact block, one for the ranking's two days — a reader could check the site's numbers without trusting the site, which is the outcome I was after.