タスクリストについて
タスクリストはタスクの集合で、それぞれのタスクはクリックできるチェックボックス付きの行に個別に表示されます。 タスクが完了しているか未完了かをマークするために、チェックボックスを選択あるいは選択解除できます。
GitHub上の任意のコメント内で、Markdownを使ってタスクリストを作成できます。 タスクリストで issue、pull request、ディスカッションを参照すると、その参照はタイトルと状態を表示するように展開されます。
Issueのタスクリストについて
タスクリストをIssueの本体に追加すると、そのリストには機能が追加されています。
- IssueについてのTeamの作業を追跡しやすくするために、Issueのタスクリストの進捗が、たとえばリポジトリのIssueのリストなど、GitHub上の様々な場所に表示されます。
- タスクが他のIssueを参照しており、誰かがそのIssueをクローズすると、そのタスクのチェックボックスは自動的に完了としてマークされます。
- さらなる追跡あるいはディスカッションがタスクに必要な場合、そのタスクにマウスを移動させ、タスクの右上のをクリックし、Issueに変換できます。 Issueを作成する前に詳細を追加するには、キーボードショートカットを使って新規Issueフォームをオープンできます。 詳しくは、「キーボード ショートカット」を参照してください。
- タスクリストから参照されているIssueは、参照元のIssueで追跡されていることを示します。
タスクリストの作成
タスク リストを作成するには、リスト アイテムの前に空白、ハイフン、[ ]
を付けます。 完了したタスクをマークするには、[x]
を使います。
- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:
参考: クローズされた issue や、リンクされた pull request を持つ issue 内では、タスクリストのアイテムを作成することはできません。
タスクの順序変更
タスクの一覧の項目は並べ替えることができます。 まず、6 つの点からなるグリッドが表示されるまでタスクのチェックボックスの左をクリックするか、そこにカーソルを置きます。 次に、そのグリッドをドラッグアンドドロップし、タスクを新しい場所まで移動します。
同じコメント中のリスト間でタスクを並べ替えることはできますが、別々のコメント間でタスクを並べ替えることはできません。
タスクを問題点に変換する
タスクを 問題点 に変換することもできます。 まず、タスク一覧のいずれかの項目の 1 つにホバーし、[ をクリックします。
追跡されたIssueへのアクセス
タスクリストから参照されているIssueは、そのタスクリストを含むIssueから追跡されていることを示します。 追跡されている Issue から追跡元のIssueへアクセスするには、Issue のステータスの隣にある [追跡元] セクション内の追跡している Issue 番号をクリックしてください。