# プル リクエストのクイックスタート

最初の変更を提案し、最初のコミットからマージされたプルリクエストまで進めましょう。

プル要求では、メイン コード ベースとは別のブランチで変更が提案されるため、他のユーザーはマージ前に変更を確認できます。 このクイック スタートでは、pull request への最も簡単なパスについて説明します。 ブランチを作成し、変更を行ってコミットし、pull request を開き、フィードバックに応答して、マージします。

GitHub Web サイトで、または上記のいずれかのタブを選択してGitHub CLIに従うことができます。

## リポジトリを分岐またはフォークする

最初に、作業する分離された場所を作成します。

<div class="ghd-tool webui">

1. GitHubで、変更を提案するリポジトリのメイン ページに移動します。
2. 必要に応じて、書き込みアクセス権がない場合は、フォークが必要です。 右上隅にある \[ **フォーク** ] をクリックし、手順に従います。 次に、フォークしたリポジトリで作業を続けます。
3. ファイル一覧の上部にあるブランチ セレクター メニューをクリックします。 それはおそらく **メイン**と言う。 新しいブランチ名を入力し、\[ **メインからブランチ *の新しいブランチ名を* 作成**] をクリックします。

</div>

<div class="ghd-tool cli"> 

1. GitHub CLIを使用するには、最初にインストールする必要があります。 「[GitHub CLI のクイック スタート](/ja/github-cli/github-cli/quickstart)」を参照してください。

2. リポジトリを複製します。 または、リポジトリをフォークし、同時にローカルに複製します。

* リポジトリへの書き込みアクセス権がある場合は、リポジトリを複製します。

  ```shell
  gh repo clone OWNER/REPO
  ```

* 書き込みアクセス権がない場合は、最初にフォークを作成し、一度にすべての **フォーク** を複製します。

  ```shell
  gh repo fork OWNER/REPO --clone
  ```

1. 複製されたリポジトリ ディレクトリに移動します。

   ```shell
   cd REPO
   ```

2. 新しいブランチを作成し、そのブランチに切り替えます。

   ```shell
   git checkout -b YOUR-BRANCH-NAME
   ```

</div>

## コードを作成または編集する

そのブランチで変更を行ってください。 最初のプル要求では、変更に重点を置いてシンプルな状態に保ちます。 pull request を小さくすると、確認が速くなり、マージが容易になります。

次のいずれかを試して変更を加えます。

* IDE またはテキスト エディターでファイルをローカルで編集します。
* GitHubで直接ファイルを編集するには、ファイルを参照して \[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit this file" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>] をクリックします。

## 頻繁にコミットする

小さな意味のあるコミットで作業を保存します。 各コミットには、スナップショットと変更を説明するメッセージが記録されます。

<div class="ghd-tool cli">

```shell
git add .
git commit -m "Describe your change"
git push --set-upstream origin YOUR-BRANCH-NAME
```

</div>

<div class="ghd-tool webui">

GitHubでファイルを編集し、コミットする準備ができたら、コミット メッセージを入力し、ブランチに直接コミットします。

1. \[ **変更のコミット]をクリックします。..**.
2. \[ **コミット] メッセージ** ボックスに、加えた変更の簡単な説明を入力します。
3. 作業しているブランチを選択します。
4. **\[変更の提案]** をクリックします。

変更内容が追加され、ブランチにコミットされます。

</div>

## pull request を開く

ブランチに提案する変更がある場合は、ベース ブランチに対して pull request を開きます。

<div class="ghd-tool webui">

1. リポジトリのメイン ページで、\[**Pull requests]\(プル要求<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-pull-request" aria-label="The pull request icon" role="img"><path d="M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z"></path></svg>** ) をクリックし、\[**New pull request]\(新しい pull request**) をクリックします。
2. **ベース** ブランチの場合、main はおそらく既に選択されており、通常はマージするベース ブランチです。
3. **比較**分岐の場合は、変更を含むブランチを選択します。
4. **\[Pull request の作成]** をクリックします。
5. 変更した内容とその理由を説明するタイトルと説明を入力します。
6. レビューの準備ができている pull request またはドラフト状態の pull request を作成できます。

* レビューの準備ができたら、\[ **pull request の作成**] をクリックします。
* 進行中の作業を共有するには、ドロップダウンを使用し、\[ **下書きプル要求の作成**] を選択します。

</div>

<div class="ghd-tool cli">

レビューの準備ができている pull request またはドラフト状態の pull request を作成できます。

* レビューの準備ができている場合は、次の手順を実行します。

  ```shell
  gh pr create
  ```

* 進行中の作業を共有するには

  ```shell
  gh pr create --draft
  ```

次に、プロンプトに従って、ベース ブランチ、タイトル、および説明を設定します。

</div>

同じブランチにさらにコミットすると、プル要求に自動的に追加されます。

## レビューを要求する

**\[レビュー担当者**] ボックスを使用してレビューを要求するには、リポジトリへの書き込みアクセス権が必要であり、リポジトリへの読み取りアクセス権を持つユーザーまたはチームにレビューを要求できます。 レビューを要求すると、ユーザーまたはチームに通知が届きます。 場合によっては、選択できるレビュー担当者候補が表示されます。

**\[校閲者**] ボックスが使用できない場合は、次のことができます。

* pull request レビューに関するガイダンスについては、リポジトリの readme を確認し、その指示に従ってください。
* レビューを実行できるユーザーがわかっている場合は、ユーザーに連絡し、pull request へのリンクを共有します。

## レビューに関するフィードバックに対処する

レビュー担当者は、プルリクエストがマージされる前に、コメントしたり、変更を提案したり、変更をリクエストしたりできます。

* 校閲者の提案を受け入れるには、\[ **提案のコミット** ] をクリックします (または、複数をバッチ処理して \[ **提案のコミット**] をクリックします)。
* より広範な変更を行うには、コードを編集し、新しいコミットを同じブランチにプッシュします。 pull request は自動的に更新され、すべてのチェックが再実行されます。
* 対処したら、各会話を **解決** 済みとしてマークします。

## マージとデプロイ

必要なレビューと状態チェックに合格したら、pull request をマージして、変更をベース ブランチに取り込みます。 変更をマージしない場合は、代わりに pull request を閉じてかまいません。

> \[!TIP]
> リポジトリが異なると、マージの要件が異なる場合があります。 関連するガイダンスを確認し、その指示に従います。

<div class="ghd-tool webui">

1. プル要求の下部にある \[ **プル要求のマージ**] をクリックします。
2. \[ **確認** ] をクリックしてマージを完了します。
3. (省略可能)ヘッド ブランチを削除して、リポジトリを整理します。

</div>

<div class="ghd-tool cli">

```shell
gh pr merge
```

プロンプトに従ってマージ メソッドを選択し、必要に応じてブランチを削除します。

</div>

## 次のステップ

最初の pull request の後、他のユーザーの作業を確認してみてください。 「[プル リクエストをレビューするクイックスタート](/ja/pull-requests/get-started/reviewing-pull-requests-quickstart)」を参照してください。

## 詳細については、次を参照してください。

* [Writing code for a project](/ja/pull-requests/concepts/writing-code-for-a-project)
* [Pull Request](/ja/pull-requests/reference/pull-requests)