GitHub: Requesting your changes be pulled from a fork
After forking the recently gitified Shoulda, I started poking around. First thing I noticed is tests were failing because some directories were missing. Presumably, this is because git ignores empty directories.
Let’s use this opportunity to using git and GitHub to contribute a fix for this, shall we?
Here’s a sky high view of the process:
- Create a fix branch
- Make changes
- Push fix branch to GitHub
- Browse to branch in browser
- Submit a ‘pull request’ to the maintainer for review
After the maintainer gets the request, they are free to do as they see fit. Accept it, tweak it, kick it, and so on.
First thing’s first. We should create a branch off of master to isolate the fix:
git checkout -b add_missing_dirs
Now the tricky part: actually fixing it. When everything is ready, I just commit it:
As always, it’s good to include meaningful commit messages. Keep in mind that if accepted, this message will become eternally bound to the repository.
With that out of the way, we actually need to push it to our ‘origin’ remote. This would be GitHub.
git push origin add_missing_dirs
Requesting the pull
We can now go to our repository on GitHub. We want to browse to the
add_missing_dirs branch. Mouse over ‘all branches’ to get there.
This gets us to the branch. Next, we indicate our desire to submit a pull request.
After you submit, you’ll get a notice that it was sent successfully, and you’ll be returned to your branch. The recipients now get a notice about this pull request, and can take appropriate action from there.
Done and done
Congratulations! You are now at the mercy of the maintainer.