HUB
Sign inSign up

rgausnet/backstroke

By rgausnet

•Updated over 9 years ago

🏊 A Github bot to keep repository forks up to date with their upstream. https:/backstroke.us

Image
0

1.1K

rgausnet/backstroke repository overview

⁠Backstroke Backstroke

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

Build Status Gratipay Team Website

Support via Gratipay

⁠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

How Backstroke 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⁠

Tag summary

Content type

Image

Digest

Size

314.8 MB

Last updated

over 9 years ago

docker pull rgausnet/backstroke