> 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/gong-tong-zuo-ye/change-requests/change-requests-in-a-space.md). # セクション内の変更リクエスト セクション内にいるとき [セクション](/docs/documentation/ja-gitbook-documentation/rifarensu/concepts.md#space)、新しい変更リクエストを開いて変更を行うことも、既存の変更リクエストを閲覧して他の人が何に取り組んでいるかを確認することもできます。 ### 変更リクエストを作成する をクリックします **編集** ボタン [セクションヘッダー](/docs/documentation/ja-gitbook-documentation/rifarensu/gitbook-ui.md#space-header) 新しい変更リクエストを開始します。 これにより新しい変更リクエストが開き、必要に応じてコンテンツを編集または削除できます。変更は自動的に保存され、他の人も変更リクエストに参加してリアルタイムで共同作業できます。 変更リクエストを作成するときに、変更内容の背景を伝えるためのタイトルと説明を追加できます。 また、変更リクエストを次のソースにリンクすることもできます。 * LinearのIssue * 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/overview.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/rifarensu/gitbook-ui.md#space-header)。これは、公開済みのドキュメントに提案した変更を含めたプレビューに切り替えるので、公開中のドキュメント全体の文脈の中で変更を確認できます。 〜の下には **プレビュー** ボタンの下には、サイトのプレビュー用URLがあります。これをクリックすると、サイトのプレビューが新しいタブで全画面表示で開きます。 プレビューURLを新しいタブで開くと、次のものも表示されます。 [プレビューツールバー](/docs/documentation/ja-gitbook-documentation/saitowosuru/customization/toolbar-on-published-sites-and-site-previews.md) ブラウザーウィンドウの下部にあります。このツールバーを使うと、GitBookにすばやく戻って変更リクエストを表示、編集、コメントしたり、サイトのライブ版を開いたりできます。 {% hint style="info" %} 変更リクエストのプレビューは、ある [公開済みドキュメントサイトで](/docs/documentation/ja-gitbook-documentation/gong-kai/publish-a-docs-site.md). {% endhint %} {% hint style="warning" %} コンテンツが共有リンクまたは認証済みアクセスを使って公開されている場合、プレビュー機能は表示されません。 {% endhint %} ### 変更リクエストでレビューを依頼する 変更をメインブランチにマージする前に、チームメンバーに内容を確認してもらいたいときは、変更リクエストでレビューを依頼します。 をクリックします **概要** セクションのヘッダーバーにあるタブを開くと、diffビューで行った変更をすべて含む変更リクエストの概要が表示されます。 次を使用してください: **概要** タブでコンテキストとレビュー担当者を追加します。エディターで差分を確認するには、 **変更** タブに切り替えてください。その表示では、差分のあるページにインジケーターが表示され、浮動表示の差分ナビゲーションコントロールを使うと、変更されたブロック間をよりすばやく移動できます。 ここでは、レビュー担当者に文脈を伝えるために変更リクエストの説明を追加したり、作業を確認してほしい特定の人をタグ付けしたりできます。 クリックすると **レビューを依頼する**、変更リクエストのステータスは次のように変わります **レビュー中**、レビュー依頼でタグ付けした人に通知が送られます。 変更にレビューが不要で、適切な [権限](/docs/documentation/ja-gitbook-documentation/gong-tong-zuo-ye/member-management/roles.md)があり、かつブロックする [マージルール](/docs/documentation/ja-gitbook-documentation/gong-tong-zuo-ye/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は左に前のバージョン、右に更新後のバージョンを表示します。これにより、編集内容を並べて比較しやすくなります。 差分があるページは目次にもインジケーターが表示されるため、大きな変更リクエストでも確認しやすくなります。 エディターの **変更** タブでページを確認していると、浮動する差分ナビゲーションコントロールによって、ページ全体をスクロールしなくても変更されたブロック間をすばやく移動できます。 diffビューを使うときには、2つのオプションがあります。 1. **すべてのページを表示** — 変更されたページと変更されていないページの両方が目次に表示されるため、セクション全体の文脈の中で編集内容を確認できます。 2. **変更されたページのみを表示** — 変更されたページだけが表示されるため、編集したコンテンツに集中できます。 次の **変更** タブに切り替えると、どの変更リクエストでもdiffビューを確認できます。

これは、変更画面の下部にあるナビゲーション操作ウィジェットです

### 変更リクエストをマージする 変更リクエストをマージすると、その変更がコンテンツのメインブランチに追加され、更新版とセクションの新しいエントリが作成されます。 [バージョン履歴](/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/version-control.md#see-the-activity-of-a-specific-draft). 適切な [権限](/docs/documentation/ja-gitbook-documentation/gong-tong-zuo-ye/member-management/permissions-and-inheritance.md)権限がない場合、または変更リクエストが組織やセクションの [マージルール](/docs/documentation/ja-gitbook-documentation/gong-tong-zuo-ye/merge-rules.md). ### 変更リクエストを更新する 変更リクエスト内で作業している間に、他の योगदान者がそのセクションのメインブランチを変更していることがあります。この場合、変更リクエストは「最新ではない」と見なされます。つまり、メインブランチには変更リクエスト内では見えないコンテンツがあるということです。 この新しいコンテンツを変更リクエストに取り込むとよいでしょう。次のような場合に便利です。 * 変更内容とメイン上のコンテンツが、すべてまとめたときにどう見えるかを確認したい場合。 * 変更リクエストの一部として、取り込んだコンテンツに変更を加える必要がある場合。 次のボタンを押すことでできます **更新** を変更リクエスト画面のヘッダーで。 それを押すと **更新**、メインブランチのすべてのコンテンツが変更リクエストに取り込まれます。更新時に競合が発生することがありますが、変更リクエスト内で解決できます。競合が解決されると、変更リクエストは最新と見なされ、更新ボタンは消えます。 メインブランチが再度変更されると、変更リクエストは再び最新ではなくなり、更新ボタンが表示されます。 マージする前に編集者に変更リクエストを最新にしておいてもらうことは、優れた品質管理です。変更リクエストがマージされたときにメインブランチに入る正確なコンテンツを著者が確認するのに役立ちます。これは次の方法で強制できます。 [マージルール](/docs/documentation/ja-gitbook-documentation/gong-tong-zuo-ye/merge-rules.md). ### マージの競合を解決する 変更リクエストをマージしたいとき、メインのコンテンツとマージしようとしているコンテンツの間で競合が見つかることがあります。最も単純な形では、競合とは自動的にマージできなかったコンテンツの一部です。 このような場合、競合アラートと、マージを続行する前に解決する必要がある競合の一覧が表示されます。 マージの競合を解決する方法は2つあります — **マージするバージョンを選択する** または **手動で** **コンテンツを編集する**. #### マージするバージョンを選択する マージの競合は、マージしたいバージョンを選ぶことで解決できます。受け取るコンテンツ、または以前そこにあったコンテンツのどちらかを選択できます。これにより、1つの変更と別の変更のどちらか、つまり最近の作業か元のコンテンツかを選べます。 この方法で解決できるマージ競合であれば、残したいバージョンを選択できます。もう一方のバージョンは削除されます。 #### 手動編集 バージョンを選びたくない場合は、競合を手動で編集してマージの競合を解決できます。不要なブロックを削除したり、完全に書き直したりすることもできます。変更に満足したら、すべての競合が解決するまで次の競合へ進めます。 ### 変更リクエストをアーカイブする 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/gong-tong-zuo-ye/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.