Diving in the Unknown depth of a project Andy Spearing © 2009

_toch toch Hi, I'm Christophe

@matylda © 2011 Intro

@matylda © 2011 The most common task

continuous typing

No content

but continuous reading Jono Witts © 2008

Each written line is read at least 1 time Gavin St. Ours © 20013

● 300 dev days ● 14633 LOC ● 634595 Changed lines ● → 634595 / 14633 ~ 43 changed LOC / LOC

For 1 final line, I read at least 43 lines.

No content

How to Dive into a project Stuart Hamilton © 2008

DO NOT Wander without a plan Felix Esteban © 2004

Journey Needs Plan Peter Southwood © 20011

Plan 1. Goal 2. Map 3. Equipment & Dive 4. Next? Peter Southwood © 20011

1. Goal Peter Southwood © 20011

➔ fix a bug ➔ implement a feature ➔ write some doc ➔ style the code ➔ refactor a small piece of code ➔ simply use it

No content

No content

~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/net/http.rb:878:in `initialize': Connection refused - connect(2) (Errno::ECONNREFUSED) from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/net/http.rb:878:in `open' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/net/http.rb:878:in `block in connect' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/timeout.rb:52:in `timeout' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/net/http.rb:877:in `connect' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/net/http.rb:862:in `do_start' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/net/http.rb:851:in `start' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:313:in `open_http' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:708:in `buffer_open' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:210:in `block in open_loop' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:208:in `catch' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:208:in `open_loop' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:149:in `open_uri' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:688:in `open' from ~/.rvm/rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/open-uri.rb:34:in `open' from -e:1:in `'

2. Map Peter Southwood © 20011

Find the Map ➔ Repository URI ➔ Project URI ➔ Intro Doc: README

Find the Map ● https://github.com/ruby/ruby ● https://bugs.ruby-lang.org/ ● https://github.com/ruby/ruby/blob/trunk/ README.md

Find the Legend

a Legend

Find the Legend ➔ CONTRIBUTING Guideline

Find the Legend ➔ CONTRIBUTING Guideline https://github.com/ruby/ruby/blob/trunk/ CONTRIBUTING.md

Find the Legend ➔ CONTRIBUTING Guideline https://github.com/ruby/ruby/blob/trunk/ CONTRIBUTING.md

Find the Legend ➔ CONTRIBUTING Guideline ➔ Directory Structure

Find the Legend ➔ CONTRIBUTING Guideline ➔ Directory Structure

Find the Legend ➔ CONTRIBUTING Guideline ➔ Directory Structure ➔ Talk to other contributors, maintainers

Find the Legend ➔ CONTRIBUTING Guideline ➔ Directory Structure ➔ Talk to other contributors, maintainers ➔ Participate to the dev meeting

If blocked? ➔ ASK!

Boris Dimitrov © 20009 3. Equipment & Dive

Get a Toolbelt ➔ Pick an Editor

No content

Get a Toolbelt ➔ Pick an Editor ➔ Bundle & Run Tests

Get a Toolbelt ➔ Pick an Editor ➔ Bundle & Run Tests ➔ Others

Get a Toolbelt ➔ ST3 ➔ Apply a Patch & Use it ➔ MRI WIKI DeveloperHowto ➔ Sign up to Ruby Redmine

Use your Toolbelt ➔ Run the App & Use it

No content

Use your Toolbelt ➔ Run the App & Use it ➔ Read & Edit the Code

➔ Find proxy management into open-uri.rb ➔ Understand how OpenURI.open_http works ➔ Spot the bug ➔ Fix it

No content

Use your Toolbelt ➔ Run the App & Use it ➔ Read & Edit the Code ➔ Report a bug ➔ Submit a contribution

No content

If blocked? ➔ ASK!

4. Next? Peter Southwood © 20011

How long? ➔ Keep it reasonable at first ➔ From ½ to 1 day

Find Next Goal ➔ Fix a bug ➔ Develop a feature ➔ Run Static Analysis Tools ➔ Review a PullRequest

Iterate ➔ :) Jean-Marc Kuffer © 2007

If blocked? ➔ ASK!

Outro 1. Goal 2. Map 3. Equipment & Dive

? _toch toch