Offer one commit upstream
A fork's writer can send a single commit of the fork to its parent as a pull.
On the web
Open a commit on your fork (/<you>/<fork>/commit/<oid>) and press Offer upstream. The
button shows only to someone who can write to a fork. The forge cuts the branch offer/<first 12
hex of the commit> in the fork at that commit, opens a pull on the parent from it, and sends you
to the pull. The pull's title is the commit's subject; its body names the fork and the commit and
says what the fork's check made of it: passed, failed, still running, superseded, or none ran.
The form works without JavaScript. The address must carry the full commit id: anything else answers 404 before git is asked.
In the terminal
Open the commit in the history screen (enter on a log row) of a fork and press o. The toast
names the pull (owner/name#N) or says why not. The pull opens through the same action as the
page, so anyone watching the parent's pulls on the web sees it appear.
Refusals, in words
OFFER_COMMIT_WORDS in src/actions/offer_commit.ts says each: not signed in, cannot write to
the fork, not a fork, upstream archived, no such commit in the fork, already offered in an open
pull, and the upstream did not take the offer.
An upstream that does not accept outside pulls is not yet a refusal of its own; only an archived one is.
Branches
If the pull fails to open, the branch this offer cut is deleted. After a pull is closed the
offer/ branch stays in the fork, and the same commit can be offered again on it.