コメントとスレッド

GitLabでは、コメント、スレッド、コードの変更提案を通じてコミュニケーションを奨励しています。コメントはMarkdownとクイックアクションをサポートしています。

次の2種類のコメントを使用できます。

• 標準コメント。
• スレッド内のコメント。これは解決できます。

コミット差分コメントでコードの変更を提案できます。ユーザーは、ユーザーインターフェースからその提案を承認できます。

コメントを追加できる場所

次のような場所にコメントを作成できます。

• コミットの差分。
• コミット。
• デザイン。
• エピック。
• イシュー。
• マージリクエスト。
• スニペット。
• タスク。
• OKR。
• Wikiページ。

各オブジェクトには、最大5,000件のコメントを付けることができます。

メンション

GitLabインスタンス内のユーザーまたはグループ（サブグループを含む）を、@usernameまたは@groupnameでメンションできます。GitLabは、メンションされたすべてのユーザーにto-doアイテムとメールを通知します。ユーザーは、通知設定でこの設定を自分で変更できます。

GitLabでは、自分（現在の認証済みユーザー）へのメンションが別の色で強調表示されるため、どのコメントが自分に関係するのかをすばやく確認できます。

誰かを作業アイテムまたはマージリクエストでメンションすると、その人はparticipantになります。

すべてのメンバーにメンションする

コメントと説明では、@allのメンションは避けてください。@allは、プロジェクト、イシュー、またはマージリクエストの参加者だけでなく、そのプロジェクトの親グループのすべてのメンバーもメンションするためです。メンションされたユーザーが、このメール通知とto-doアイテムを受け取った結果、スパムであると受け取ってしまう可能性があります。

この機能フラグを有効にすると、コメントと説明に@allと入力すると、すべてのユーザーをメンションする代わりにプレーンテキストになります。この機能を無効にすると、Markdownテキスト内の既存の@allメンションは変更されず、リンクとして残ります。今後の@allメンションのみがプレーンテキストとして表示されます。

通知とメンションはgroup settingsで無効にできます。

イシューまたはマージリクエストでグループをメンションする

コメントでグループをメンションすると、グループのすべてのメンバーのto-doアイテムがto-doリストに追加されます。

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. あなたのマージリクエストまたはイシューへ移動します:
   • マージリクエストの場合、コード > マージリクエストを選択し、あなたのマージリクエストを見つけます。
   • イシューの場合、Plan > 作業アイテムを選択し、あなたのイシューを見つけます。
3. コメントで、@の後にユーザー、グループ、またはサブグループのネームスペースを入力します。たとえば、@alex、@alex-team、または@alex-team/marketingなどです。
4. コメントを選択します。

GitLabは、すべてのグループおよびサブグループメンバーのto-doアイテムを作成します。

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

マージリクエストの差分にコメントを追加する

マージリクエストの差分にコメントを追加すると、次の場合でも、これらのコメントは保持されます。

• リベース後に強制プッシュする。
• コミットを修正する。

コミット差分コメントを追加するには、次の手順に従います。

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 左サイドバーで、コード > マージリクエストを選択し、あなたのマージリクエストを見つけます。
3. コミットタブを選択し、コミットメッセージを選択します。
4. コメントを開始します。
   • ファイル全体にコメントするには、コメントするファイルを見つけ、ファイルヘッダーで、このファイルにコメントする（ ）を選択します。
   • 特定の行にコメントするには、コメントする行番号を見つけます。行番号にカーソルを合わせるて、コメント（ ）を選択します。複数の行を選択するには、コメント（ ）アイコンをドラッグします。
5. コメントを入力します。
6. コメントを送信します。
   • コメントをすぐに送信するには、今すぐコメントを追加を選択するか、キーボードショートカットを使用します。
     • macOS: Shift+Command+Enter
     • その他すべてのOS: Shift+Control+Enter
   • レビューを完了するまでコメントを公開しないようにするには、レビューを開始を選択するか、キーボードショートカットを使用します。
     • macOS: Command+Enter
     • その他すべてのOS: Control+Enter

コメントは、マージリクエストの概要タブに表示されます。

コメントは、プロジェクトのコード > コミットページには表示されません。

メールを送信してコメントに返信する

「メールで返信」が構成されている場合は、メールを送信してコメントに返信できます。

• 標準コメントに返信すると、別の標準コメントが作成されます。
• スレッドコメントに返信すると、スレッドに返信が作成されます。
• イシューのメールアドレスにメールを送信すると、標準コメントが作成されます。

メールの返信で、Markdownとクイックアクションを使用できます。

コメント返信の有効期限

標準コメントまたはスレッドコメントを作成するメール返信は、2年間の保持ポリシーの対象となります。

コメントを編集する

自分のコメントはいつでも編集できます。メンテナーまたはオーナーロールを持つユーザーは、他のユーザーが作成したコメントも編集できます。

コメントを編集するには、次の手順に従います。

1. コメントで、コメントの編集（ ）を選択します。
2. 編集を行います。
3. 変更を保存を選択します。

メンションを追加するためにコメントを編集する

デフォルトでは、ユーザーをメンションすると、GitLabはそのユーザーのto-doアイテムを作成し、通知メールを送信します。

既存のコメントを編集して、以前になかったユーザーメンションを追加すると、GitLabは次のようになります。

• メンションされたユーザーのto-doアイテムを作成します。
• メンションされたユーザーに通知メールを送信します。

ディスカッションをロックしてコメントを防止する

イシューまたはマージリクエストでパブリックコメントを防止できます。その場合、プロジェクトメンバーのみがコメントを追加および編集できます。

前提条件:

• マージリクエストでは、デベロッパー、メンテナー、またはオーナーのロールが必要です。
• イシューでは、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。

イシューまたはマージリクエストをロックするには、次の手順に従います。

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. あなたのマージリクエストまたはイシューへ移動します:
   • マージリクエストの場合、コード > マージリクエストを選択し、あなたのマージリクエストを見つけます。
   • イシューの場合、Plan > 作業アイテムを選択し、あなたのイシューを見つけます。
3. 右上隅で、マージリクエストアクションまたはイシューアクション（ ）を選択し、ディスカッションのロックを選択します。

GitLabが、システムノートをページの詳細に追加します。

イシューまたはマージリクエストを再度開くには、クローズされたイシューまたはマージリクエストで、ロックされたすべてのディスカッションのロックを解除する必要があります。

機密アイテムに関するコメント

機密アイテムにアクセスする権限を持つユーザーのみが、そのアイテムに関するコメントの通知を受け取ります。アイテムが以前に機密にされていなかった場合、アクセス権のないユーザーが参加者として表示されることがあります。これらのユーザーは、アイテムが機密である間は通知を受け取りません。

通知を受け取ることができるユーザー:

• ロールに関係なく、アイテムに割り当てられたユーザー。
• アイテムを作成したユーザーで、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持つユーザー。
• アイテムが属するグループまたはプロジェクトにおいて、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持つユーザー。

内部メモを追加する

公開イシュー、エピック、Wikiページ、またはマージリクエストに追加された情報を保護するために、内部ノートを使用します。内部メモは公開コメントとは異なります。

• 少なくともレポーターの役割を持つプロジェクトメンバーのみが、内部メモを表示できます。
• 内部メモを通常のコメントに変換することはできません。
• 内部メモへのすべての返信も内部ノートです。
• 内部メモには内部メモバッジが表示され、公開コメントとは異なる色で表示されます。

前提条件:

• プロジェクトのレポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。

内部メモを追加するには、次の手順に従います。

1. イシュー、エピック、Wikiページ、またはマージリクエストで、コメントテキストボックスにコメントを入力します。
2. コメントの下にあるこれを内部メモにするを選択します。
3. 内部メモを追加を選択します。

イシュー全体を機密としてマークしたり、機密マージリクエストを作成したりすることもできます。

コメントのみを表示する

コメントが多いディスカッションでは、ディスカッションをフィルターリングして、コメントまたは変更履歴（システムノート）のみを表示します。システムノートには、説明の変更、他のGitLabオブジェクトでのメンション、またはラベル、担当者、マイルストーンへの変更が含まれます。GitLabは設定を保存し、表示するすべてのイシュー、マージリクエスト、またはエピックに適用します。

1. マージリクエスト、イシュー、またはエピックで、概要タブを選択します。
2. ページの右側にある並べ替えとフィルタリングドロップダウンリストから、次のフィルターを選択します。
   • すべてのアクティビティを表示: すべてのユーザーコメントとシステムノートを表示します。
   • コメントのみ表示: ユーザーコメントのみを表示します。
   • 履歴のみ表示: アクティビティノートのみを表示します。

アクティビティの並べ替え順序を変更する

既定の順序を逆にして、上部に最新のアイテムが並べ替えられたアクティビティフィードを操作します。GitLabはローカルストレージに設定を保存し、表示するすべてのイシュー、マージリクエスト、またはエピックに適用します。イシューとエピックは同じ並べ替え設定を共有しますが、マージリクエストはそれぞれ個別の設定を保持します。

アクティビティの並べ替え順序を変更するには、次の手順に従います。

1. イシューを開くか、マージリクエストまたはエピックで概要タブを開きます。
2. アクティビティの見出しまでスクロールします。
3. ページの右側で、並べ替え順序を変更します。
   • イシューとエピック: 並べ替えとフィルタリングドロップダウンリストから、新しい順または古い順（デフォルト）を選択します。
   • マージリクエスト: 並べ替え方向の矢印ボタンを使用して、ソート順: 昇順（古い順、デフォルト）またはソート順: 降順（新しい順）を切り替えます。

説明の変更履歴を表示する

履歴にリストされている説明への変更を確認できます。

変更を比較するには、前のバージョンと比較を選択します。

コメントしているユーザーにイシューを割り当てる

コメントをしたユーザーにイシューを割り当てることができます。

1. コメントで、その他のアクション（ ）メニューを選択します。
2. コメント作成者に割り当てるを選択します。
3. コメンターの割り当てを解除するには、ボタンをもう一度選択します。

標準コメントに返信してスレッドを作成する

標準コメントに返信すると、スレッドが作成されます。

前提条件:

• ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
• イシュー、マージリクエスト、またはエピックにいる必要があります。コミットとスニペットのスレッドはサポートされていません。

コメントに返信してスレッドを作成するには、次の手順に従います。

1. コメントの右上隅にあるコメントに返信（ ）を選択して、返信セクションを表示します。
2. 返信を入力します。
3. 返信または今すぐコメントを追加（UIのどこに返信しているかによって異なります）を選択します。

GitLabは、上部のコメントをスレッドに変換します。

コメントに返信せずにスレッドを作成する

標準コメントに返信せずにスレッドを作成できます。

前提条件:

• ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
• イシュー、マージリクエスト、コミット、またはスニペットにいる必要があります。

スレッドを作成するには、次の手順に従います。

1. コメントを入力します。
2. コメントの下のコメントの右側にある下矢印（ ）を選択します。
3. リストから、スレッドを開始を選択します。
4. もう一度スレッドを開始を選択します。

スレッドを解決する

会話が完了したら、スレッドを解決することができます。解決済みのスレッドは折りたたまれますが、ユーザーは引き続きコメントを追加できます。

解決済みのスレッドは、スレッドを解決する権限を持つ任意のユーザーによって、後で再オープンできます。解決済みのスレッドを再オープンするには、スレッドを展開するしてスレッドを再オープンを選択します。

前提条件:

• エピック、イシュー、タスク、目標、主な成果、またはマージリクエストにいる必要があります。
• デベロッパー、メンテナー、またはオーナーのロールを持っているか、イシューまたはマージリクエストの作成者である必要があります。

スレッドを解決するには、次の手順に従います。

1. スレッドに移動します。
2. 次のいずれかを実行します。
   • 元のコメントの右上隅で、スレッドを解決する （ ）を選択します。
   • 最後の返信の下にある返信欄で、スレッドを解決するを選択します。
   • 最後の返信の下にある返信欄にテキストを入力し、スレッドを解決にするチェックボックスを選択して、今すぐコメントを追加を選択します。

同様のアクションは、スレッドを再オープンするためにも実行できます。

マージリクエストは、次のようなより柔軟なスレッド管理オプションを提供します:

• 新しいイシューに未解決のスレッドを移動します。
• すべてのスレッドが解決されるまで、マージを禁止する。

イシューディスカッションをGitLab Duo Chatで要約する

イシューに関するディスカッションのサマリーを生成します。

概要を見る

前提条件:

• イシューを表示する権限が必要です。

イシューのディスカッションのサマリーを生成するには、次の手順に従います。

1. イシューで、アクティビティセクションまでスクロールします。
2. サマリーを表示を選択します。

イシューのコメントが、最大10個のリスト項目に要約されます。回答に基づいてフォローアップの質問をすることができます。

データ使用量: この機能を使用すると、イシューのすべてのコメントのテキストが大規模言語モデルに送信されます。