text GitHubのフォーク（fork）とプルリクエスト（拉动请求）の使い方

Posted 2021-05-03

■共有リポジトリ

リポジトリ （しばしば "repo" と呼ばれます） は、GitHub が、プロジェクトに関連するファイルをまとめて保管する単位です。CreateJS 翻訳プロジェクトも CreateJS/localization という名前のリポジトリを持っています。
これをチーム内で共有して、作業目的ごとにブランチ （Branch） と呼ばれるコピーを作り、適当なタイミングでブランチに対して行われた更新をオリジナル （Master Branch） に反映するというのが、GitHub を使った共同開発の 1 つのパターンとされています。
この方式では、参加者が同じリポジトリ内で更新を行うため、事前に調整が必要になることもあり、比較的管理が容易な小規模でプライベートなプロジェクトに向いていると言われています。ということで、CreateJS 翻訳プロジェクトはこちらの方法を採用していません。

■リポジトリのフォーク

GitHub のアカウントを持っていると、自分のアカウント内に既存のリポジトリの複製をつくれたりします。この操作はフォークと呼ばれます。
共有されていないリポジトリに対して書き込むことはできません。一方、フォークしたリポジトリは自分の所有物なので、自由に更新ができます。
つまり、自分のフォークを作れば、共有されていないリポジトリをベースとした作業も （勝手に） 始められることになります。
GitHub には、自分のフォーク内の更新を反映するよう、オリジナルの管理者に依頼する手段があります。この依頼を受け取った管理者が、依頼どおりにオリジナルを更新すれば、リポジトリを共有しない共同開発の実現です。
こちらの方式の場合、調整が必要なのは、オリジナルを更新 （マージ） する際の修正内容だけです。事前に開発者間のコーディネートが不要なため、オープンソースプロジェクト向きと言われています。CreateJS のドキュメント翻訳はこちらの方式をとっています。

■プルリクエストを送るまでの手順概要

GitHub アカウント作成 & ログイン
①オリジナルのリポジトリを自分のアカウントにフォーク （fork）
②オリジナルまたはフォークしたリポジトリをローカル環境にクローン （clone）
③クローンしたリポジトリ内で開発作業を行う
④クローンで行った更新を、フォークしたリポジトリにコミット
⑤フォークしたリポジトリからオリジナルのリポジトリにプルリクエスト （Pull Request） を送信
⑥上記ステップ 1～3 は、初回だけ必要な作業です。2 回目以降の更新作業では、特に問題が無ければ、ステップ 4～6 の繰り返しになります。

ここで新しく出てきた言葉に、ステップ 3 のクローン （clone） と、ステップ 6 のプルリクエスト （pull request） があります。

■クローン

フォークは GitHub サーバー上でリポジトリの複製を作成する行為でした。クローンは、サーバー上のリポジトリを、クライアント環境に複製する行為です。
GitHub はファイルを管理する場所であって、開発する場所ではありません。そこで、開発作業を行う際は、ローカル PC のフォルダ内にリポジトリをコピーしてきてから （クローンの作成） 、それを使って開発やテストを行います。

■プルリクエスト

前述のように、直接オリジナルのリポジトリに書き込めない場合は、クライアント側で行った更新作業を、フォークしたリポジトリを経由して、オリジナルリポジトリの管理者通知するという手順をとります。
その際、オリジナルの管理者に更新を依頼する手段として使われるのが、プルリクエストという機能です。
GitHub では （というより一般的に）、更新をリポジトリに書き込む作業をプッシュ、他のリポジトリから更新を取り込むことをプルと呼びます。ここでは、相手にプルによる自分のフォークとの同期をお願いすることから、プルリクエストと呼ばれていると考えられます。
プルリクエストの発行後の作業は、オリジナルリポジトリの管理者任せになります。