> 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/collaboration/change-requests/change-requests-in-a-space.md). # セクション内の変更リクエスト ある [セクション](/docs/documentation/ja-gitbook-documentation/rissu/concepts.md#space)内にいるときは、新しい変更リクエストを開いて変更を加えることも、既存の変更リクエストを参照して他の人が何に取り組んでいるかを見ることもできます。 ### 変更リクエストの作成 次の **編集** のボタン [セクション見出し](/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui.md#space-header) 新しい変更リクエストを開始します。 これにより新しい変更リクエストが開き、必要に応じてコンテンツの編集や削除ができます。変更内容は自動的に保存され、他の人も変更リクエストに参加してリアルタイムで共同作業できます。 変更リクエストを作成するときに、加えている変更の背景を示すタイトルと説明を追加できます。 変更リクエストを次のようなソースにリンクすることもできます。 * Linearの課題 * GitHubのプルリクエストまたは課題 * 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を改善する * わかりやすさを高める * 一貫性を確認する * 誤字脱字やスペルミスを修正する * 関連コンテンツをリンクする * +その他 次を参照してください: [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/collaboration/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 %} ### 変更リクエストでレビューを依頼する 変更をメインブランチにマージする前にチームメンバーに内容を確認してもらいたいときは、変更リクエストでレビューを依頼します。 次の **概要** タブをセクションヘッダーバーで開くと、差分ビューで行ったすべての変更を含む変更リクエストの概要を確認できます。 の **概要** タブを使って、文脈とレビュー担当者を追加します。エディターで差分を確認するには、 **変更** タブに切り替えてください。その表示では、差分のあるページにインジケーターが表示され、フローティングの差分ナビゲーションコントロールで変更されたブロック間をすばやく移動できます。 ここでは、レビュー担当者に文脈を伝えるための説明を変更リクエストに追加したり、作業内容を確認してほしい特定の人をタグ付けしたりできます。 をクリックすると **レビューを依頼する**、変更リクエストのステータスは **レビュー中**に変わり、レビュー依頼でタグ付けした人全員に通知が届きます。 変更内容にレビューが不要で、適切な [権限](/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 %} #### 差分ビュー ページに差分がある場合、GitBookは中央に浮かぶインジケーターも表示します。それをクリックすると、最初の変更ブロックまたは要素までスクロールできます。 を開くと **変更** タブをセクションヘッダーで開くと、GitBookは変更リクエストで編集されたすべてのページとブロックを表示します。GitBookは左に以前のバージョン、右に更新後のバージョンを表示します。これにより、編集内容を並べて比較しやすくなります。 差分を含むページは目次にもインジケーターが表示されるため、大きな変更リクエストでも確認しやすくなります。 エディターの **変更** タブでページを確認していると、浮動する差分ナビゲーションコントロールにより、ページ全体をスクロールせずに変更されたブロック間をすばやく移動できます。 差分ビューを使う場合は、次の2つのオプションがあります。 1. **すべてのページを表示** — 変更済みと未変更のページの両方を目次に表示するため、セクション全体の文脈の中で編集内容を確認できます。 2. **変更されたページのみを表示** — 変更されたページだけを表示するため、編集済みコンテンツに集中できます。 に切り替えて **変更** タブで、任意の変更リクエストの差分ビューを確認できます。

これは［変更］画面下部にあるナビゲーションコントロールウィジェットです

### 変更リクエストをマージする 変更リクエストをマージすると、その変更内容がコンテンツのメインブランチに追加され、更新版とセクションの新しいエントリが作成されます [バージョン履歴](/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つの選択肢があります — **マージするバージョンを選択する** または **手動で** **コンテンツを編集する**. #### マージするバージョンを選択する 取り込むバージョンを選ぶことでマージ競合を解決できます。取り込むコンテンツ、または以前そこにあったコンテンツのどちらかです。これにより、新しい変更と元のコンテンツのどちらかを選べます。つまり、最近の作業か元の内容のどちらかです。 この方法で解決できるマージ競合がある場合は、保持したいバージョンを選択でき、もう一方のバージョンは削除されます。 #### 手動で編集する バージョンのどちらかを選びたくない場合は、競合部分を手動で編集してマージ競合を解決できます。不要なブロックを削除したり、完全に書き直したりすることもできます。変更に満足したら、すべて解決するまで次の競合に進めます。 ### 変更リクエストをアーカイブする GitBookで変更リクエストを削除することはできませんが、代わりにアーカイブできます。 変更リクエストをアーカイブするには： 1. 次を開きます： **変更リクエスト** タブ。 2. アーカイブしたい変更リクエストをクリックします。 3. 次の **アクション** メニュー The Actions menu icon in GitBook を変更リクエストのタイトルの横で開き、 **アーカイブ**. アーカイブ済みの変更リクエストを見つけて再度開くには、 **変更リクエスト** メニューを開いて **アーカイブ済み** タブ。 --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaboration/change-requests/change-requests-in-a-space.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.