3.5 KiB
title, intro, allowTitleToDifferFromFilename, versions, type, topics
| title | intro | allowTitleToDifferFromFilename | versions | type | topics | |||
|---|---|---|---|---|---|---|---|---|
| About tasklists | You can use tasklists to quickly sketch out projects, divide tasks into subtasks, and track issues and pull requests. | true |
|
overview |
|
{% note %}
Notes:
- Tasklists are currently in private beta and subject to change. If you are interested in trying tasklists, you can join the waitlist. Tasklists build upon the previous iteration of task lists.
- For the best experience, we recommend adding no more than 50 tasks to a tasklist and no more than 5 tasklists per issue. There is a hard limit of 250 tasks per tasklist and 10 tasklists per issue.
{% endnote %}
About tasklists and issue hierarchy
You can add a tasklist to an issue to quickly break down larger pieces of work into subtasks. You can sketch out a draft of your plans, in either Markdown or in the UI, and optionally convert those draft tasks into real issues or add existing issues and pull requests to your tasklists.
When you add issues and pull requests to a tasklist, the tasklist will show metadata associated with the issue or pull request, including any labels applied, the avatars of people assigned, and the open/close state. When you view the issues and pull requests that have been added to a tasklist, {% data variables.product.product_name %} shows which issues are tracking that subtask.
Tasklists add support for hierarchies of issues on {% data variables.product.product_name %} by creating relationships between your issues. You can create parent and child relationships, you can also create multiple levels of hierarchy that accurately represent your project by breaking down tasks into exactly the amount of detail that you and your team require.
You can create a tasklist using Markdown or using the {% data variables.product.product_name %} UI. Regardless of how you created your tasklist, you can edit it using either Markdown or the UI. For more information, see "AUTOTITLE" and "AUTOTITLE."
Tasklists also integrate with your projects. {% ifversion projects-v2-tasklists-without-breadcrumbs %}You can{% else %}When you click on an issue in your project, the side-panel opens and displays the issue's place in the hierarchy on a breadcrumb menu, allowing you to navigate through the issues included in your tasklists. You can also{% endif %} add the "Tracks" and "Tracked-by fields" to your project views to quickly see the relationships between your issues. For information, see "AUTOTITLE."