Contribute to rails

Preview:

DESCRIPTION

Talk given on 2011-11-24 at a Stockholm Ruby User Group meetup.

Citation preview

To contribute

to Ruby

on Rails

I

WANT

YOU

I felt like that too!

It's not that hard…

Sure you can!

Thanks, Johannes Edelstam :)

We should have more of those.

Go to an Open Source Hacknight!

Find something you want to fix,

then…

open http://github.com/rails/railsSearch issues and pull requests – don't duplicate work

First, fork Rails

Clone your repo

Add github.com/rails/rails as upstream git remote

Set up a local copy

Use rvm or rbenv – tests give some warnings in 1.9.

Bundle install – I got warnings about journey, but it works.

Bundle exec rake test – takes about 30 mins on my laptop.

Get the tests running

Pick a good branch name. Others will see it.

Clear, concise code as always! Follow the Rails coding style.

Write tests, and make sure all tests pass.

Have someone else look at the code. (Thanks, David Billskog)

Create a branch and go to work

First, fetch from upstream and rebase your work.

Push your branch to origin – your github repo.

Go to your new branch on github.

Push the magic Pull Request button.

Push to github & do a Pull Request

Explain your code and why it should be merged into Rails.

Your message starts a discussion thread.

If you need to make changes, do them and push them. The pull request will be automatically updated.

Help the Rails team. Be kind. In return, they'll help you.

Pull Request primer

Boom!

That was easy

Add a new remote docrails: git@github.com:lifo/docrails.git

Create a new docrails branch, set to track docrails remote.

Make documentation fixes and push them straight up.

Boom! You're a contributor!

But there's a quicker way…

Now you're one of THEM

http://contributors.rubyonrails.org/

Happy camper ->

Resources

RailsGuides: Contributing to Ruby on Railshttp://guides.rubyonrails.org/contributing_to_ruby_on_rails.html

Rails BugMash Guidehttp://bugmash.com/BugMashManual.pdf

Railscasts #300 Contributing to Open Sourcehttp://railscasts.com/episodes/300

Recommended