処理中タグ

処理中タグ(デフォルト設定の場合は#wip)を作業中チェンジリストの説明に追加すると、作業内容をレビューする準備がまだできていないことがSwarmによって認識されます。例えば、変更内容のレビューがリクエストされたときに、段階的にそれらの変更内容を確認し、作業が完了した時点ですべての変更内容をレビューする場合などに、処理中タグを作業中チェンジリストの説明に追加します。変更内容をレビューする準備ができたら、チェンジリストの説明から#wipを削除し、シェルフを更新してレビューを行います。

注意

  • デフォルトの処理中タグは#wipですが、Swarmの管理者は、必要に応じて変更することができます。詳しくは、「タグプロセッサ」を参照してください。

  • 以下の説明では、デフォルトの処理中タグ「#wip」が組織内で使用されていることを想定しています。別の処理中タグを使用する場合は、そのタグに置き換えて以下の説明を読んでください。

  • 処理中タグは、作業中チェンジリストに対してのみ適用されます(プリコミットレビュー)。

サマリ

処理中タグ:

  • 処理中タグをチェンジリストの説明に追加すると、その説明に#review キーワードが含まれている場合であっても、そのチェンジリストに対して新しいレビューが作成されることはありません。

  • 処理中タグをチェンジリストの説明に追加すると、その説明に#review-1234 キーワードが含まれている場合であっても、そのチェンジリストでファイルの追加、編集、削除、ファイル名の変更を行う際に、既存のレビューを更新できなくなります。

  • 処理中タグをチェンジリストの説明に追加すると、その説明にキーワードが含まれている場合であっても、そのチェンジリストに既存のレビューを付加できなくなります。例えば、#append-1234、#replace-1234、#review-1234などのキーワードです。

  • 処理中タグをチェンジリストの説明に追加すると、レビューの説明を同期する機能が有効になっている場合であっても、対象となるレビューの説明を同期できなくなります。チェンジリストの説明から#wipタグを削除すると、レビューの説明がSwarmによって同期されます。

チェンジリストの説明から#wipタグを削除すると、次にそのチェンジリストを操作したときに(ファイルの追加、編集、削除、ファイル名の変更)、Swarmによってレビューが更新されます。#wipタグを削除しただけでは、レビューは更新されません。

処理中タグを使用してワークフローのルールを回避することはできません。処理中タグは、組織内で設定されたルールを回避するための手段ではありません。

処理中タグを使用して、コミットに関連するレビューの更新を禁止することはできません。

処理中タグの使用方法

処理中タグを作業中チェンジリストに追加する

  1. 作業中チェンジリストの説明に#wipタグを追加します。

  2. チェンジリスト内のファイルを必要な頻度で更新します。

    Swarmにより、新しいレビューの作成や既存のレビューの更新が行われることはありません。

処理中タグの削除とレビューの更新

  1. 変更内容をレビューする準備ができたら、チェンジリストの説明から#wipタグを削除します。

  2. ファイルに対する操作(ファイルの追加、編集、削除、ファイル名の変更)を行い、チェンジリストの状態を更新します。

    Swarmにより、新しいレビューの作成または既存のレビューの更新が実行され、レビュアーの準備が整います。