ビットコイン・インスティテュート

PULLリクエストの作り方

1件のメッセージ BitcoinTalk ギャビン・アンドレセン 2011年3月17日 — 2011年3月17日

bitcoinの統合とテストのためのソースツリーはGitHub (https://github.com/bitcoin/bitcoin)にある。私たち(今はjgarzik、tcatm、gavinandresen)は、GitHubの「プルリクエスト」の機能を使って、本体のbitcoinに入れる準備ができたと作者が考えるパッチを管理している。この投稿では、プルリクエストの作り方を順に説明する。

  1. GitHubのアカウントが要る。無料で登録して (http://github.com/signup)、GitHubで使えるようにgitとsshを設定する (http://help.github.com/set-up-git-redirect)。

  2. bitcoinの本体のソースツリーのフォークが要る。GitHubのアカウントにログインして、bitcoinのプロジェクト (https://github.com/bitcoin/bitcoin)を開き、画面の上のほうにある小さな「Fork」のボタンを押す。

  3. GitHubのそのフォークを、開発に使うマシンのソースコードとつなぐ。一番簡単なのは、フォークのページにGitHubが表示するSSHの読み書き用のURLを使って、GitHubのフォークをクローンすることだ。たとえば次のようにする。

git clone git@github.com:your_github_name/bitcoin-git.git
cd bitcoin-git
git checkout -b niftynewfeature # Create a feature branch
 ... edit, test, re-edit, re-test...
git commit -a
git push git@github.com:your_github_name/bitcoin.git niftynewfeature:niftynewfeature

すでにbitcoinのgitのツリーをクローンして、手を入れているかもしれない。その場合は、その変更を新しいGitHubのフォークにプッシュする。自分のマシンの「master」ブランチで変更したのなら(次からは、機能ごとのブランチを作ったほうがいい)、コマンドは次のようになる。

git commit -a
git rebase -i remotes/origin/HEAD  # optional: lets you tidy up commits to create a clean patch
git push git@github.com:your_github_name/bitcoin.git master:niftynewfeature
  1. フォークのGitHubのページを開き、取り込んでほしい変更の入ったブランチ(上の例では「niftynewfeature」)を選んで、「Pull Request」のボタンを押せば、PULLリクエストを出せる。その変更が何をするのか、なぜ良い考えなのか、そして誰も彼もがすでにそれを使って世界を良くしていることを、しっかり説明に書く。

うまくいけば、議論と言い合いとあら探しと手直しを経て、いずれあなたの変更はbitcoinのリポジトリに取り込まれる。うまくいかなければ、あなたが(または中心の開発者が)プルリクエストを閉じて、その機能が完璧になってから出し直せばいい。