プロジェクト ボードは、issue、pull request、選んだ列内でカードとして分類されるノートから構成されます。 列内のカードの並び替え、列から列へのカードの移動、および列の順序の変更には、ドラッグアンドドロップまたはキーボードショートカットが利用できます。
プロジェクト ボードのカードには、ラベル、担当者、状態、オープンした人など、issue や pull request に関連するメタデータが含まれます。 プロジェクト ボード 内の issue および pull request を表示したり、軽量の編集を行うには、その issue または pull request のタイトルをクリックします。
タスクのリマインダとして機能するノートを列内に作成し、ご自分のエンタープライズ上の任意のリポジトリからの issue や pull request を参照させたり、プロジェクト ボードに関係する情報を追加したりできます。 ノートにリンクを追加することで、他のプロジェクト ボードを参照するカードを作成することもできます。 ノートでは要求を満たせない場合、ノートを Issue に変換することができます。 ノートから issue への変換について詳しくは、「project board にノートを追加する」をご覧ください。
プロジェクトボードには以下の種類があります:
- ユーザー所有のプロジェクト ボード には、すべての個人用リポジトリの issue と pull request を含めることができます。
- Organization 全体のプロジェクト ボード には、Organization に属するすべてのリポジトリの issue と pull request を含めることができます。 最大 25 個のリポジトリを Organization またはユーザー所有の プロジェクト ボード にリンクできます。 リポジトリをリンクすると、 [カードの追加] を使用して、または issue や pull request のサイドバーで、issue および pull request をそれらのリポジトリから プロジェクト ボード に簡単に追加できます。詳しくは、「project boardへのリポジトリのリンク」をご覧ください。
- リポジトリ プロジェクト ボード は、1 つのリポジトリ内の issue と pull request に範囲設定されます。 他のリポジトリの Issue やプルリクエストを参照するノートも含まれます。
プロジェクト ボード の作成と表示
Organization のプロジェクト ボードを作成するには、Organization のメンバーである必要があります。 Organization の所有者とプロジェクト ボードの管理アクセス許可を持つユーザーは、プロジェクト ボード へのアクセスをカスタマイズできます。
Organization が所有するプロジェクト ボードに、あなたが表示アクセス許可を持っていないリポジトリからの issue あるいは pull request が含まれている場合、そのカードは編集されます。 詳しくは、「Organization の Project board へのアクセス許可」を参照してください。
アクティビティ ビューには、誰かが作成したカードや、列間での移動など、プロジェクト ボードの最近の履歴が表示されます。 アクティビティビューにアクセスするには、 [メニュー] をクリックして下にスクロールします。
プロジェクト ボード上の特定のカードを検索したり、カードのサブセットを表示したりするには、プロジェクト ボード カードをフィルター処理できます。 詳しくは、「project boardでのカードのフィルタリング」を参照してください。
ワークフローを簡素化し、完了したタスクがプロジェクト ボードに混ざらないように、カードをアーカイブできます。 詳しくは、「project boardでのカードのアーカイブ」を参照してください。
プロジェクト ボード タスクをすべて完了した場合、またはプロジェクト ボードを使用する必要がなくなった場合は、プロジェクト ボードを閉じることができます。 詳しくは、「project board を閉じる」を参照してください。
別の方法で作業を追跡したい場合は、リポジトリ内のプロジェクト ボードを無効にしたり、Organization 内のプロジェクト ボードを無効にしたりもできます。
GitHubのAPIを使って、プロジェクトボードをインポートできます。 詳しくは、「ミューテーション」を参照してください。
プロジェクト ボードのテンプレート
テンプレートを使用すると、新しいプロジェクト ボードをすばやく設定できます。 テンプレートを使用してプロジェクト ボードを作成する場合、新しいボードには列と、project boardsを使用するためのヒントがあるカードが含まれます。 また、自動化が設定済みのテンプレートを選択することもできます。
| テンプレート | 説明 |
|---|---|
| Basic kanban | [To do]、[In progress]、[Done] 列でタスクを追跡します。 |
| Automated kanban | カードは自動的に [To do]、[In progress]、[Done] の列間を移動します。 |
| Automated kanban with review | プルリクエストレビューのステータスのための追加のトリガーで、カードは [To do]、[In progress]、[Done] 列の間を自動的に移動します。 |
| Bug triage | [To do]、[High priority]、[Low priority]、[Closed] 列でバグのトリアージと優先順位付けをします。 |
project boards での自動化について詳しくは、「project boards の自動化について」をご覧ください。