Public | Automated Build

Last pushed: 8 months ago
Short Description
🏊 A Github bot to keep repository forks up to date with their upstream. https:/backstroke.us
Full Description

Backstroke

A Github bot to keep a fork updated with any changes made to its upstream.



Add Backstroke to a repository

  1. Go to backstroke.us, and sign in with your Github account.
  2. Click Create new link
  3. Add a source repo under the text From (the big, green box)
  4. Add a destination repository under the text To, or choose All Forks to
    sync to all forks of the source repo.
  5. Click Save. If you push a change to the repo listed under From, you'll
    get a pull request with any updates in the repo(s) under To!

How it works

For a contributor

  1. You push code to Github.
  2. Backstroke will create a pull request with any unmerged upstream changes.
  3. You accept Backstroke's pull request, and have updated code. Merging your
    code back upstream later on is painless.

For an open source maintainer

  1. You get a pull request from a contributor.
  2. Backstroke will create a pull request on their fork that lets them merge in
    your upstream changes.
  3. They accept Backstroke's pull request, and you merge in their code.

FAQ

  • I don't see any pull requests on the upstream....: Pull requests are
    always proposed on forks. Take a look there instead.

  • I didn't sign up for this and now I'm getting pull requests. What's going
    on?
    : This is because the upstream added backstroke to their repository.
    Some project maintainers use backstroke as an easy way to keep contributor's
    local forks up-to-date with later changes, but if you'd rather tackle that
    unassisted, here's how to disable backstroke on a fork.

  • Why isn't Backstroke working?: Take a look at the webhook response logs. Most likely, you'll see an error. Otherwise, open an issue.

  • Is Backstroke really all that useful?: If you never merge upstream, then no, not really. Otherwise, if you hate
    resolving merge conflicts, then it's great.

  • Does Backstroke work outside of Github?: Not yet. If there's interest, I'd love to give it a try, though.


By Ryan Gaus

Docker Pull Command
Owner
rgausnet
Source Repository