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.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs