How I submitted my first patch to Rails (and you can too!)
Making your first contribution to a large open source project like Rails seems daunting at first. A good way to get started is to submit patches to improve the documentation.
In my previous post,
I wrote about the
and how the documentation for it was missing.
This gave me an excellent opportunity to
get my first commit into Rails by adding the documentation.
If you’re looking to get started with submitting your own patch to Rails, here’s how you can do it in 4 simple steps:
- Fork the rails/rails repo on Github and clone your fork to your local machine.
- Create a new branch for your patch
and make your changes there.
[ci skip]to your commit message so that the Rails CI servers skip running tests for your documentation commit.
- Push your changes to your Github repo and open a pull request to the main Rails repo.
- Once you’ve opened a PR, someone from the Rails team will provide feedback, suggesting improvements, or accept the changes and merge the PR. Congratulations, you now have your first commit on Rails!
There’s another project, docrails, that exists specifically to help make it easier to contribute to Rails documentation. That repo used to have an open commit policy, ie. anybody could commit directly to it, but these days you need to ask the Rails team to grant you commit access.
Going through docrails lets you contribute directly without going through the pull request workflow. This is the easier option if you’re planning to make a lot of documentation changes. But if you aren’t sure about the changes you’re proposing, it’s better to go via the main Rails repo where others can discuss the changes before merging it.
Keeping your repo up-to-date
There are lots of open issues in Rails, so it might take some time for your patch to be merged. In the meanwhile, you might want to make sure your local copy of Rails is up-to-date with the upstream Rails repo. To do this, follow these steps:
This adds the main Rails repo as a remote called
and fetches all new changes form it.
You can update your fork with the latest commits from upstream by:
Before I submitted this patch, I was under the impression that it would be a lot of work to get a patch accepted into Rails. Which is why I wrote this down - in the hopes that it convinces someone else to give it a shot. If you see something about the docs that could be improved, you now know how easy it is to contribute. :)