<p>Pull requests are a way to poke someone and let them know you’ve got some code they may want.</p>
<p>They work great when you want to let an upstream maintainer know that you’ve pushed some useful changes to your fork of their project.</p>
<p>They also work great if you want to let a fellow developer know that you’ve pushed some experimental features to an arbitrary branch.</p>
<h3>Step One</h3>
<p>First, navigate to your project with the changes you want someone else to pull. In this instance, I’m going to go to <a href="http://github.com/defunkt/grit">defunkt/grit</a> and tell mojombo to pull a change.</p>
<p><img src="http://img.skitch.com/20080223-xw8wdwkg9abpjtuwu4wutwwcqm.png"/></p>
<h3>Step Two</h3>
<p>I can type in a message if I want and select any number of recipients. By default, I’ll see everyone who has a project in my project’s network. If I want to add someone else, I can use the autocompleter and click ‘add.’</p>
<p><img src="http://img.skitch.com/20080223-1njj3f5559un2eyt51j92t2xkf.png"/></p>
<h3>Step Three</h3>
<p>Sent!</p>
<p><img src="http://img.skitch.com/20080223-8jf2dc17cdtibs2jt13ptgxwts.png"/></p>
<h3>Step Four</h3>
<p>When mojombo logs in, he’ll see that there’s a new message waiting for him.</p>
<p><img src="http://img.skitch.com/20080223-rpgh5c4e1n38wc3e45cacq77ww.png"/></p>
<h3>Step Five</h3>
<p><img src="http://img.skitch.com/20080223-p9erf1mhepf5gc7jy9kek9rgdn.png"/></p>
<p>mojombo can reply to my message, delete it, or ignore it. Pulling from me is easy. mojombo can add the defunkt repository as a remote source and fetch its contents like this:</p>
<pre class="console">
<span>$</span> git remote add defunkt git://github.com/defunkt/grit.git
<span>$</span> git fetch defunkt
</pre>
<p>The ‘git remote add’ will stay in your repository configuration, so the next time you get a pull request, you only need to fetch again. Note that to fetch from a private repository, you need to use the private update <span class="caps">URL</span>. If grit were private for example, the remote add would look like, “git@github.com:defunkt/grit.git”.</p>
<p>To merge the changes done in the defunkt repository to a local branch, e.g., the master branch, you can run</p>
<pre class="console">
<span>$</span> git checkout master
<span>$</span> git merge defunkt/master
</pre>
<p>You can also use the git-pull helper to do the fetch+merge in one step. This comes in handy for one-shot pulls where you do not want to use the same repository again in the near future:</p>
<pre class="console">
<span>$</span> git checkout master
<span>$</span> git pull git://github.com/defunkt/grit.git master
</pre>
<p>Now that you have merged defunkt/grit’s master branch, you should probably push your branch to let others see the merge.</p>
2008-02-23T01:31:04-08:00
16
pull-requests
Pull Requests
2009-11-15T03:39:18-08:00
153510