ノート: 改善されたタスクリストは現在ベータであり、変更されることがあります。
タスクリストについて
タスクリストはタスクの集合で、それぞれのタスクはクリックできるチェックボックス付きの行に個別に表示されます。 タスクが完了しているか未完了かをマークするために、チェックボックスを選択あるいは選択解除できます。
GitHub上の任意のコメント内で、Markdownを使ってタスクリストを作成できます。 タスクリストでIssue、Pull Request、ディスカッションを参照すると、その参照はタイトルと状態を表示するように展開されます。
Issueのタスクリストについて
タスクリストをIssueの本体に追加すると、そのリストには機能が追加されています。
- IssueについてのTeamの作業を追跡しやすくするために、Issueのタスクリストの進捗が、たとえばリポジトリのIssueのリストなど、GitHub上の様々な場所に表示されます。
- タスクが他のIssueを参照しており、誰かがそのIssueをクローズすると、そのタスクのチェックボックスは自動的に完了としてマークされます。
- さらなる追跡あるいはディスカッションがタスクに必要な場合、そのタスクにマウスを移動させ、タスクの右上のをクリックし、Issueに変換できます。 Issueを作成する前に詳細を追加するには、キーボードショートカットを使って新規Issueフォームをオープンできます。 詳細は「キーボードのショートカット」を参照してください。
- タスクリストから参照されているIssueは、参照元のIssueで追跡されていることを示します。
タスクリストの作成
To create a task list, preface list items with a hyphen and space followed by [ ]. タスクを完了したとマークするには[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内では、タスクリストのアイテムを作成することはできません。
タスクの順序変更
タスクリスト内のアイテムは、タスクのチェックボックスの左をクリックし、新しい場所へドラッグして落とすことによって、順序を変更できます。 同じコメント中のリスト間でタスクを並び替えることができますが、別々のコメント間でタスクを並び替えることはできません。
追跡されたIssueへのアクセス
タスクリストから参照されているIssueは、そのタスクリストを含むIssueから追跡されていることを示します。 追跡されているIssueから追跡元のIssueへアクセスするには、Issueのステータスの隣にあるTracked inセクション内の追跡しているIssue番号をクリックしてください。
参考リンク
- 「基本的な執筆とフォーマットの構文」
- 「タスクリストを使ったIssue内のcode scanning アラートの追跡」