GitHub でプル リクエストを開く方法

GitHub でプル リクエストを開く方法

プル リクエスト (PR) は、書き込みアクセス権のないリポジトリへの変更を提案できるようにする GitHub の機能です。リポジトリの管理者はこれらの変更を確認し、必要に応じて元のリポジトリにマージできます。

GitHub でプル リクエストを開くことは、オープンソース プロジェクトに貢献し、他の開発者と協力する上で非常に重要です。いくつかの簡単な手順で、GitHub でプル リクエストを作成して開く方法を学びます。

ステップ 1: リポジトリのフォーク

GitHub プラットフォームでリポジトリをフォークすると、アカウントの下にそのリポジトリのコピー (「フォーク」とも呼ばれます) が作成されます。リポジトリをフォークすると、元のリポジトリに影響を与えずにコードを変更できます。

リポジトリをフォークするには、そのメイン ページに移動し、右上隅にあるフォークボタンをクリックします。

強調表示された GitHub フォーク ボタン

リポジトリ名 (フォーク) とオプションの説明を入力し、[ Create fork ] をクリックします。

GitHub の新しいフォーク作成フォーム

これで、元のリポジトリのコピーが作成されました。この新しいリポジトリは元のリポジトリと接続されているため、コードに加えた変更を簡単に比較してマージすることができます。

ステップ 2: コードを変更する

リポジトリをフォークした後、提案する変更の量と性質に応じて、ローカル マシンにクローンする必要がある場合があります。テストする必要のない非常に単純な変更を行っている場合は、GitHub Web ベースのエディターを使用してオンラインで行うことができます。

Git を使用してリポジトリをローカル マシンにクローンするには、次のターミナル コマンドを実行します。

git clone <REPOSITORY_URL>

<REPOSITORY_URL>をリポジトリの URL に置き換えます。これは GitHub にあります。このコマンドは、リポジトリをローカル マシンにクローンします。そこで自由に実験し、コードを変更できます。

大きなプル リクエストはレビューとマージが困難になる可能性があるため、変更は小さく集中的に行う必要があります。変更を 1 つの問題または機能に固有のものにして、保守担当者が簡単にレビューして受け入れられるようにしてください。

必要な変更をローカルで行った後、それらをコミットし、Git を使用して GitHub フォークにプッシュします。

ステップ 3: プル リクエストを開く

変更を GitHub にコミットすると、ブランチがフォーク元のリポジトリよりも数回「コミット」されていることを警告するプロンプトが表示されます。次に例を示します。

アップストリーム リポジトリの前にあるプロジェクトを示す GitHub メッセージ。

[投稿] ドロップダウンをクリックします。このボタンをクリックすると、プル リクエストを開くように求められます。次に、[プル リクエストを開く] ボタンをクリックします。

プル リクエストを開くボタンが強調表示された GitHub リポジトリのメイン ページ

一部のリポジトリには、特定のコントリビューション ガイドラインがあり、通常は CONTRIBUTING.md ファイルで確認できます。これに従う必要があります。プル リクエストを送信する前に、これらのガイドラインを読み、それに従ってください。

次に、必須フィールドに入力し、[プル リクエストの作成] ボタンをクリックします。

[作成] ボタンが強調表示された GitHub プル リクエスト フォーム。

コミット メッセージは明確かつ簡潔で、行った変更とその理由を説明する必要があります。これにより、メンテナは変更を理解しやすくなり、コードのレビューが容易になります。

プルを作成したら、プロジェクトのメンテナーがプルをレビューしてマージするかクローズするまで待つ必要があります。メンテナーは、プル リクエストに関する提案やフィードバックを提供する場合があります。変更を受け入れ、要求された場合は喜んで修正します。

プルリクエストの重要性

プル リクエストは、開発者が変更を提案し、フィードバックを提供し、コードをレビューできるようにすることで、開発者間のコラボレーションを促進します。これにより、プロジェクト内のコミュニティとコラボレーションの感覚が育まれ、より多くの貢献とより迅速な開発につながります。

さらに、プル リクエストは、メンテナーがコードのさまざまなバージョンと各バージョンに加えられた変更を追跡できるようにすることで、プロジェクトの履歴とバージョン管理を整理します。

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です