> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/change-requests.md).

# 変更リクエスト

変更リクエストを通じてコンテンツ編集を共同で行います

変更リクエストは、メインコンテンツのコピーです。これはブランチングの概念に基づいており、GitHub の pull request や GitLab の merge request を使ったことがある人にはおなじみの仕組みです。

変更リクエストでは、コンテンツの編集、更新、削除を行い、変更のレビューを依頼したうえで、メイン版にマージし直すことができます。

サイト全体のオープンな変更リクエストを閲覧、管理するには、 [変更リクエスト画面](https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/change-requests/change-requests-screen.md).

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-6c42a248be934280f9e37216a5fa95d1142a5d24%2F25_12_10_collaboration_change_requests%402x.png?alt=media" alt="A GitBook screenshot showing the change requests panel"><figcaption><p>変更リクエストを通じてコンテンツを編集します。</p></figcaption></figure>

### 差分ビューで変更をレビュー <a href="#diff-mode" id="diff-mode"></a>

「 **変更** 」タブを開くと、変更リクエスト内の編集内容を確認できます。すべてのページを文脈の中で確認することも、変更されたページだけに絞って確認することもできます。

変更リクエストのヘッダーには、Gitと同じ形式で変更量が表示されます。追加、変更、削除の数が、たとえば **+12 Δ3 −6**のように示され、色付きのバーでそれぞれの割合がわかります。レビュー担当者は変更を開く前に、誤字の修正なのか全面的な書き換えなのかを判断できます。

レビュー中、サイドバーには進捗が **N / M 件を確認済み**として表示されます。レビューが終わったページごとに **確認済み** にチェックを入れてください。

エディタ下部のフローティング差分ナビゲーターを使うと、変更されたブロック間を移動したり、差分のある次のページへ進んだり、利用可能なレビュー操作を使って最後の変更からレビューを完了したりできます。

{% hint style="info" %}
既定では、変更は「分割ビュー」で表示されます。左側にページの「変更前」バージョン、右側に「変更後」バージョンが表示されます。変更を1カラムのレイアウトでインライン表示したい場合は、目次パネル右上の差分モードボタンをクリックします。
{% endhint %}

### 変更リクエストを作成してマージする

{% stepper %}
{% step %}

### 変更リクエストを開く

コンテンツを編集するには、変更リクエストを開きます。開く方法はいくつかあります。

* セクションの右上にある「 **編集** 」をクリックします。
* GitBook Agent に代わりに作成してもらいます。
* GitBook Agent は、ドキュメントの不足を検出すると自動的に作成する場合があります。

手動で開くと、GitBook が変更リクエストを作成し、エディタで開きます。
{% endstep %}

{% step %}

### 変更を加える

エディタで直接コンテンツを編集するか、GitBook Agent を使って作業します。

次に進む前に変更を確認してください。レビューを依頼できる状態になるまで、編集を続けられます。
{% endstep %}

{% step %}

### レビューを依頼する

「 **概要** 」タブを開き、1人以上のレビュアーにタグを付けます。

レビュアーは変更を承認したり、コメントを残したり、さらなる編集を依頼したりできます。誰もタグ付けしない場合、そのセクションでレビュアー権限を持つ全員に通知されます。そのセクションにレビュアーがいない場合は、代わりに編集者と管理者に通知されます。

誰かが変更を依頼した場合、マージする前に変更リクエストを更新してください。GitBook Agent に変更リクエストのレビューを依頼することもできます。
{% endstep %}

{% step %}

### マージ

変更リクエストが承認されたら、「 **概要** 」タブを開き、 **マージ**.

GitBook は変更内容をライブドキュメントに即座に適用します。セクションでマージルールを使用している場合、GitBook はマージ前にそれらを確認します。

マージは元に戻せません。コンテンツを元に戻すか調整するには、新しい変更リクエストを開いてください。
{% endstep %}
{% endstepper %}

### 変更リクエストの扱い方

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>変更リクエスト画面</strong></td><td>組織全体の変更リクエストを表示・管理する</td><td><a href="https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/change-requests/change-requests-screen.md">変更リクエスト画面</a></td></tr><tr><td><strong>スペース内の変更リクエスト</strong></td><td>1つのスペースで変更リクエストを作成・レビューする</td><td><a href="https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/change-requests/change-requests-in-a-space.md">セクション内の変更リクエスト</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/change-requests.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
