チュートリアル: イシュートリアージ用のプロジェクトをセットアップする

トリアージとは、タイプと重大度に応じて分類するプロセスです。プロジェクトが成長し、人々がより多くのイシューを作成するにつれて、受信イシューをトリアージするためのワークフローを作成する価値があります。

このチュートリアルでは、このためのGitLabプロジェクトを設定する方法を学習します。

プロジェクトでイシュートリアージのためにGitLabを設定するには:

1. プロジェクトを作成する
2. タイプ、重大度、優先順位の基準を決定する
3. 基準をドキュメント化する
4. スコープ付きラベルを作成する
5. 新しいラベルを優先する
6. イシュートリアージボードを作成する
7. 機能のイシューを作成する

はじめる前

• このチュートリアルで既存のプロジェクトを使用している場合は、プロジェクトのレポーター、デベロッパー、メンテナー、またはオーナーのロールを持っていることを確認してください。
• 以下の手順に従い、後でプロジェクトの親グループを作成することを決定し、ラベルを最大限に活用するには、プロジェクトラベルをグループラベルにプロモートする必要があります。まずグループを作成することを検討してください。

プロジェクトを作成する

プロジェクトには、今後のコード変更を計画するために使用されるイシューが含まれています。

既に作業中のプロジェクトがある場合は、タイプ、重大度、および優先順位の基準を決定するに進んでください。

空のプロジェクトを作成するには:

1. 右上隅で、新規作成（ ）と新規プロジェクト/リポジトリを選択します。
2. 空のプロジェクトの作成を選択します。
3. プロジェクトの詳細を入力します。
   • プロジェクト名に、Issue triage tutorialと入力します。
4. プロジェクトを作成を選択します。

タイプ、重大度、優先順位の基準を決定する

次に、以下を決定する必要があります:

• Types。より詳細なアプローチが必要な場合は、各タイプにサブタイプを作成することもできます。タイプは、チームにリクエストされる作業の種類を理解するために、作業を分類するのに役立ちます。
• priorities順位とseveritiesのレベルを、受信作業がエンドユーザーに与える影響を定義し、優先順位付けを支援するために使用します。

このチュートリアルでは、以下を決定したとします:

• タイプ: Bugバグ、Feature機能、およびMaintenanceメンテナンス
• 優先順位: 1、2、3、および4
• 重大度: 1、2、3、および4

GitLabでのこれらの定義については、以下を参照してください:

• タイプとサブタイプ
• 優先順位
• 重大度

基準をドキュメント化する

すべての基準に同意したら、チームメイトがいつでもアクセスできる場所にすべて書き留めてください。

たとえば、プロジェクトのWiki、またはGitLab Pagesで公開されている会社のハンドブックに追加します。

スコープ付きラベルを作成する

次に、イシューを分類するために追加するラベルを作成します。

これに最適なツールはスコープ付きラベルで、これを使用して相互に排他的な属性を設定できます。

以前にまとめたタイプ、重大度、および優先順位のリストを確認し、一致するスコープ付きラベルを作成する必要があります。

スコープ付きラベルの名前にあるダブルコロン (::) は、同じスコープの2つのラベルが同時に使用されるのを防ぎます。たとえば、type::featureラベルを既にtype::bugがあるイシューに追加すると、以前のラベルが削除されます。

各ラベルを作成するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 左サイドバーで、管理 > ラベルを選択します。
3. 新しいラベルを選択します。
4. タイトルフィールドに、ラベルの名前を入力します。type::bugで始まる。
5. オプション。使用可能な色から選択するか、背景色フィールドに特定の色を表す16進数のカラー値を入力して、色を選択します。
6. ラベルを作成を選択します。

必要なすべてのラベルを作成するために、これらの手順を繰り返します:

• type::bug
• type::feature
• type::maintenance
• priority::1
• priority::2
• priority::3
• priority::4
• severity::1
• severity::2
• severity::3
• severity::4

新しいラベルを優先する

次に、新しいラベルを優先ラベルとして設定します。これにより、優先順位またはラベルの優先順位でソートした場合に、最も重要なイシューがイシューリストの最上部に表示されるようになります。

優先順位またはラベルの優先順位でソートした場合に何が起こるかについては、イシューリストのソートと順序付けを参照してください。

ラベルの優先度を設定するには:

1. ラベルページで、優先するラベルの横にある星 ( ) を選択します。このラベルは、ラベルリストの最上部、優先ラベルの下に表示されます。
2. これらのラベルの相対的な優先度を変更するには、リストを上下にドラッグします。リストの上位にあるラベルは、より高い優先度を取得します。
3. 以前に作成したすべてのラベルを優先します。優先順位と重大度が高いラベルが、低い値のラベルよりもリストの上位にあることを確認してください。

イシュートリアージボードを作成する

受信イシューバックログに備えるには、イシューをラベルで整理するイシューボードを作成します。これを使用して、カードをさまざまなリストにドラッグすることで、イシューをすばやく作成し、ラベルを追加できます。

イシューボードを設定するには:

1. ボードのスコープを決定します。たとえば、イシューに重大度を割り当てるために使用するボードを作成します。
2. トップバーで検索または移動先を選択し、Issue triage tutorialプロジェクトを見つけます。
3. 計画 > イシューボードを選択します。
4. イシューボードページの上部左隅にあるドロップダウンリストで、現在のボード名を選択します。
5. 新しいボードを作成を選択します。
6. タイトルフィールドにIssue triage (by severity)と入力します。
7. オープンリストを表示するチェックボックスをオンにし、クローズドリストを表示するチェックボックスをオフにします。
8. ボードを作成するを選択します。空のボードが表示されるはずです。
9. severity::1ラベルのリストを作成します:
   1. イシューボードページの右上隅で、Create listを選択します。
   2. 表示されるカラムで、値ドロップダウンリストからseverity::1ラベルを選択します。
   3. ボードに追加を選択します。
10. 以前の手順をseverity::2、severity::3、およびseverity::4ラベルに対して繰り返します。

現時点では、ボードのリストは空であるはずです。次に、いくつかのイシューをそれらに投入します。

機能のイシューを作成する

今後の機能やバグを追跡するには、いくつかのイシューを作成する必要があります。イシューはプロジェクトに属しますが、イシューボードから直接作成することもできます。

まず、計画された機能のイシューをいくつか作成します。バグを見つけたら(バグが多すぎないことを願っています！)、イシューを作成できます。

**Issue triage (by severity)**ボードからイシューを作成するには:

1. オープンリストで、イシューの新規作成 ( ) を選択します。オープンリストには、他のどのボードリストにも適合しないイシューが表示されます。

   どの重大度ラベルをイシューに付けるべきか既に分かっている場合は、そのラベルリストから直接作成できます。ラベルリストから作成された各イシューには、そのラベルが付けられます。

2. フィールドに入力します:

   • タイトルの下に、User registrationと入力します。

3. イシューを作成を選択します。

4. さらにいくつかのイシューを作成するために、これらの手順を繰り返します。

   たとえば、アプリを構築している場合は、次のイシューを作成します:

   • User registration
   • Profile creation
   • Search functionality
   • Add to favorites
   • Push notifications
   • Social sharing
   • In-app messaging
   • Track progress
   • Feedback and ratings
   • Settings and preferences

最初のトリアージイシューボードの準備ができました！オープンリストからいくつかのイシューをラベルリストのいずれかにドラッグして、いずれかの重大度ラベルを追加してみてください。

次の手順

その後、次のことができるようになります。

• イシューボードの使用方法を微調整する。次のようなオプションがあります。

  • 現在のイシューボードを編集して、優先順位とタイプラベルのリストも持つようにします。これにより、ボードが広くなり、水平スクロールが必要になる場合があります。
  • 別々のイシューボードをIssue triage (by priority)とIssue triage (by type)という名前で作成します。これにより、さまざまな種類のトリアージ作業を分離できますが、ボードを切り替える必要があります。
  • チームハンドオフ用のイシューボードを設定する。

• イシューリストで、優先順位または重大度別にイシューを閲覧し、各ラベルでフィルターします。利用可能な場合は、「いずれかである」フィルター演算子を使用してください。

• イシューをタスクに分解します。

• gitlab-triage gemを使用して、プロジェクト内のイシュートリアージを自動化するポリシーを作成します。次のレポートのように、ヒートマップを含む概要レポートを生成します:

  

GitLabでのイシュートリアージの詳細については、イシュートリアージとトリアージオペレーションを参照してください。