# プルリクエストについて

プル要求を使用して、 GitHubでの変更の提案、ディスカッション、マージを行います。

プル要求では、あるブランチから別のブランチにコード変更をマージすることを提案します。 共同機能として、pull requests を使用すると、プロジェクトの一部になる前に作業について話し合い、レビューすることができます。

## pull request を使用する理由

プル要求は、一連のコード変更を会話に変換します。 作業を直接マージするのではなく、共同作業者が意見を出せるように提案します。 これは、お客様とチームが、いくつかの方法で高品質で安全なコードを維持するのに役立ちます。

* メイン ブランチに到達する前に、バグや問題を早期にキャッチします。
* 特定の行に関連付けられたフィードバックを使用して、一緒に変更について話し合い、改善します。
* 変更された内容とその理由を明確に確認できる履歴を保持します。

## プルリクエストでできること

プル要求を使用すると、変更を簡単に確認および検証できます。 pull request を使用すると、次のことができます。

* ブランチまたはフォークから変更を提案する。
* 提案された変更について、1 行ずつ話し合って確認します。
* 変更に対してテスト、ビルド、コード スキャンなどの自動チェックを実行します。
* フィードバックに対応し、変化に応じてプル リクエストを更新します。
* レビューが完了し、必要なチェックに合格したら、変更をマージしてください。

## プルリクエストの主要な部分

pull request は、自分とレビュー担当者が必要とするすべてのものを 1 つの場所に収集します。

* **会話** には、説明、コメント、レビュー、アクティビティのタイムラインが表示されます。
* **コミットは、** 時間の経過と同時にブランチがどのように変化したかを示します。
* **チェック** では、自動テスト、ビルド、およびその他の検証の結果が表示されます。
* **変更されたファイル** には、レビュアーがコメントする対象の差分が表示されます。
* **マージ ボックス**には、変更をマージできるかどうかが要約されます。 プル要求をマージする前に、必要なレビューやチェックなど、引き続き何が必要かを示します。

## pull requests がワークフローにどのように適合するか

変更を提案する場合でも、他のユーザーのレビューを行う場合でも、pull request はいくつかの段階に従います。

* リポジトリを**分岐またはフォーク**して、作業する分離された場所を作成します。
* 作業の**履歴を作成**して、変更をコミットします。
* **プル要求を開いて** 、変更をベース ブランチにマージすることを提案します。
* 必要に応じて更新を行い、コラボレーターと変更を**確認して話し合**います。
* 準備ができたら、pull request を**マージ**します。

## 次のステップ

* [プル リクエストのクイックスタート](/ja/enterprise-server@3.17/pull-requests/get-started/pull-request-quickstart)
* [プル リクエストをレビューするクイックスタート](/ja/enterprise-server@3.17/pull-requests/get-started/reviewing-pull-requests-quickstart)
* [Writing code for a project](/ja/enterprise-server@3.17/pull-requests/concepts/writing-code-for-a-project)