# スペース内の変更リクエスト

あなたが次の中にいるとき [スペース](/docs/documentation/ja-gitbook-documentation/rissu/concepts.md#space)、新しい変更リクエストを開いて変更を加えたり、既存の変更リクエストを参照して他の人が何に取り組んでいるかを確認したりできます。

### 変更リクエストの作成

クリックして **編集** ボタンを [スペースヘッダー](/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui.md#space-header) して新しい変更リクエストを開始します。

これにより新しい変更リクエストが開き、必要に応じてコンテンツを編集または削除できます。変更は自動的に保存され、他の人も変更リクエストに参加してリアルタイムで共同作業できます。

変更リクエストを作成する際には、タイトルと説明を追加して、行っている変更についてより多くの文脈を提供できます。

変更リクエストをソースにリンクすることもできます。これには次が含まれます：

* Linear の課題
* GitHub のプルリクエストまたは issue
* Jira チケット
* 一般的な URL

これらのリンクは変更リクエスト上に表示されるため、レビュー担当者は作業をその起点までたどることができます。

変更に満足したら、ヘッダーバーのボタンを使って [**レビューを依頼する**](#request-a-review-on-a-change-request) 変更リクエストの [**マージ**](#merging-a-change-request) それを直接メインブランチに。

#### GitBook Agent で変更リクエストを作成する

[GitBook Agent](/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md) は AI のチームメイトで、 [変更リクエストを計画して実装する](/docs/documentation/ja-gitbook-documentation/gitbook-agent/write-and-edit-with-ai.md#implement-a-change-request-with-gitbook-agent) あなたが与えるあらゆる指示に基づいて。

GitBook Agent で新しい変更リクエストを開くには、「編集」ボタンの横にある右上の GitBook Agent アイコンをクリックし、必要な変更を実装するよう GitBook に依頼します。

依頼できることの例は次のとおりです：

* 使用例を追加する
* ページの SEO を改善する
* 明確さを向上させる
* 一貫性を確認する
* &#x20;টাইポやスペルミスを修正する
* 関連コンテンツをリンクする
* \+ その他

次へ移動します [GitBook Agent で執筆する](/docs/documentation/ja-gitbook-documentation/gitbook-agent/write-and-edit-with-ai.md) をご覧ください。

### 変更リクエストをプレビューする

変更リクエストで行った変更は、 **プレビュー** 内の [スペースヘッダー](/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui.md#space-header)をクリックすることでプレビューできます。これにより、提案された変更を含む公開済みドキュメントのプレビューに切り替わり、公開中のドキュメント全体の文脈の中で変更を確認できます。

の下にある **プレビュー** ボタンの下には、サイトプレビュー用の URL があります。これをクリックすると、サイトプレビューが新しいタブで完全表示されます。

新しいタブでプレビュー URL を開くと、 [プレビュー ツールバー](/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui/toolbar-on-published-sites-and-site-previews.md) もブラウザウィンドウの下部に表示されます。このツールバーを使うと、GitBook にすばやく戻って変更リクエストを表示、編集、コメントしたり、サイトのライブ版を開いたりできます。

{% hint style="info" %}
変更リクエストをプレビューできるのは、次に追加されたスペースのみです [公開済みドキュメントサイトで](/docs/documentation/ja-gitbook-documentation/docs-site/publish-a-docs-site.md).
{% endhint %}

{% hint style="warning" %}
コンテンツが共有リンクまたは認証アクセスを使用して公開されている場合、プレビュー機能は表示されません。
{% endhint %}

### 変更リクエストでレビューを依頼する

変更をメインブランチにマージする前にチームメンバーにコンテンツを確認してほしい場合は、変更リクエストでレビューを依頼してください。

次を選択します **概要** スペースのヘッダーバーのタブを開くと、行ったすべての変更を diff 表示で含む変更リクエストの概要が開きます。

ここでは、レビュー担当者に文脈を伝えるために変更リクエストに説明を追加したり、作業を確認してほしい特定の人にタグ付けしたりできます。

クリックすると **レビューを依頼する**、変更リクエストのステータスは次に変わります **レビュー中**、またレビュー依頼でタグ付けした全員に通知が届きます。

変更にレビューが不要で、適切な [権限](/docs/documentation/ja-gitbook-documentation/collaboration/member-management/roles.md)を持っており、ブロックする [マージルール](/docs/documentation/ja-gitbook-documentation/collaboration/merge-rules.md)がない場合は、代わりに変更を直接メインバージョンへマージできます。

{% hint style="info" %}
[GitBook Agent をレビュアーとして追加する](/docs/documentation/ja-gitbook-documentation/gitbook-agent/review-change-requests-with-gitbook-agent.md) を変更リクエストに追加すると、スペル、文法、スタイルガイドの誤りを確認し、改善案の提案などを行えます。
{% endhint %}

{% hint style="warning" %}
レビュー依頼で誰にもタグ付けしない場合、レビュアー権限を持つ全員に依頼の通知が届きます。スペース内にレビュアーがいない場合は、レビュアーの一つ上のロールに通知されます。
{% endhint %}

#### Diff 表示 <a href="#diff-mode" id="diff-mode"></a>

を開くと **変更** スペースヘッダーのタブで、diff 表示が表示されます。diff 表示では、変更リクエストで編集されたすべてのページとブロックが強調表示されます。目次内で編集されたページが強調表示され、ページ上では追加、編集、削除された具体的なブロックが表示されます。

diff 表示を使用する際には、2 つのオプションがあります：

1. **すべてのページを表示** – これは diff 表示のデフォルトモードで、目次に変更されたページと変更されていないページの両方を表示します。スペース全体の文脈の中で、どのページが編集されたかを確認するのに適しています。
2. **変更されたページのみを表示** – このモードでは、目次に変更されたページのみが表示されるため、変更されたコンテンツに集中しやすくなります。これは、ページやサブページが多い大規模なスペースで特に役立ちます。

に切り替えることができます **変更** タブに切り替えて、どの変更リクエストでも diff 表示を確認できます。

### 変更リクエストをマージする

変更リクエストをマージすると、変更リクエストの変更がコンテンツのメインブランチに追加され、更新されたバージョンとスペースの [バージョン履歴](/docs/documentation/ja-gitbook-documentation/creating-content/version-control.md#see-the-activity-of-a-specific-draft).

変更リクエストをマージできない場合があります。適切な [権限](/docs/documentation/ja-gitbook-documentation/collaboration/member-management/permissions-and-inheritance.md)を持っていない場合、または変更リクエストが組織またはスペースの [マージルール](/docs/documentation/ja-gitbook-documentation/collaboration/merge-rules.md).

### 変更リクエストを更新する

変更リクエスト内で作業している間に、他のコントリビューターがスペースのメインブランチを変更している場合があります。これが起こると、変更リクエストは「古い状態」と見なされます。つまり、メインブランチにはあるが、変更リクエスト内では見えていないコンテンツが存在します。

この新しいコンテンツを変更リクエストに取り込みたい場合があります。これは次のような場合に便利です：

* 自分の変更とメイン上のコンテンツが、すべて一緒になったときにどう見えるか確認したい。
* 変更リクエストの一部として、取り込んだコンテンツに変更を加える必要がある。

これは、 **更新** を変更リクエスト画面のヘッダーで押すことで行えます。

を押すと **更新**、メインブランチからのすべてのコンテンツが変更リクエストに取り込まれます。更新時に競合が発生する場合がありますが、変更リクエスト内で解決できます。競合が解決されると、変更リクエストは最新の状態と見なされ、\[更新] ボタンは消えます。

メインブランチが再び変更されると、変更リクエストは再度古い状態になり、\[更新] ボタンが表示されます。

マージ前に編集者の変更リクエストを最新の状態にしておくよう求めることは、優れた品質管理です。変更リクエストがマージされたときに、メインブランチに入る正確なコンテンツを著者が確認する助けになります。これは [マージルール](/docs/documentation/ja-gitbook-documentation/collaboration/merge-rules.md).

### マージ競合を解決する

変更リクエストをマージしようとしたときに、メインコンテンツとマージしようとしているコンテンツの間に競合が見つかることがあります。最も単純な形では、競合とは自動的にマージできなかったコンテンツの一部です。

これが発生すると、競合アラートと、マージを続行する前に解決する必要がある競合の一覧が表示されます。

マージ競合を解決する方法は 2 つあります — **マージするバージョンを選択する** または **手動で** **コンテンツを編集する**.

#### マージするバージョンを選択する

マージしたいバージョン、つまり取り込まれるあなたのコンテンツか、以前からあったコンテンツのどちらかを選ぶことで、マージ競合を解決できます。これにより、ある変更と別の変更のどちらを採用するか、つまり最近の作業か元のコンテンツかを選べます。

この方法で解決できるマージ競合に対処している場合は、保持したいバージョンを選択でき、もう一方のバージョンは削除されます。

#### 手動で編集する

バージョン間で選びたくない場合は、競合を手動で編集することでマージ競合を解決できます。不要なブロックを削除したり、完全に書き直したりすることもできます。変更に満足したら、すべて解決するまで次の競合に進めます。

### 変更リクエストをアーカイブする

変更リクエストをマージしないことに決め、キューから削除したい場合は、アーカイブできます。

変更リクエストをアーカイブするには、まずそれを開きます。次に、 **アクションメニュー** <picture><source srcset="/files/HXFvPsjDqbaBEhpH0WKJ" media="(prefers-color-scheme: dark)"><img src="/files/fd3eb2aee07f495b1836c7d8e6ac4e9cb930d4e1" alt="The Actions menu icon in GitBook"></picture> を変更リクエストのタイトルの横でクリックし、 **アーカイブ**を選択します。アーカイブされた変更リクエストは、後で **変更リクエスト** メニューを開いて **アーカイブ済み** タブを選択することで見つけて再度開くことができます。


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaboration/change-requests/change-requests-in-a-space.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
