Merge branch 'main' into repo-sync
This commit is contained in:
Octomerger Bot
BIN
assets/images/help/issues/tasklist-formatting-toolbar.png
Normal file
BIN
assets/images/help/issues/tasklist-formatting-toolbar.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 22 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 1.2 MiB After Width: | Height: | Size: 1.2 MiB |
@@ -38,7 +38,7 @@ You can use custom fields to add metadata to your issues, pull requests, and dra
|
||||
|
||||
You can use Tasklists to build hierarchies of issues, dividing your issues into smaller subtasks, and creating new relationships between your issues. For more information, see "[About Tasklists](/issues/tracking-your-work-with-issues/about-tasklists)."
|
||||
|
||||
These relationships are displayed on the issue, as well as the Tracked-by and Tracks fields in your projects. You can filter by issues which are tracked by another issue, and you can also group your table views by the Tracked-by field to show all parent issues with a list of their subtasks.
|
||||
These relationships are displayed on the issue, as well as the Tracked by and Tracks fields in your projects. You can filter by issues which are tracked by another issue, and you can also group your table views by the Tracked by field to show all parent issues with a list of their subtasks.
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: About Tracks and Tracked-by fields
|
||||
shortTitle: About Tracks and Tracked-by fields
|
||||
title: About Tracks and Tracked by fields
|
||||
shortTitle: About Tracks and Tracked by fields
|
||||
intro: You can view the subtasks of the issues in your projects.
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
@@ -12,11 +12,11 @@ topics:
|
||||
|
||||
{% data reusables.projects.tasklists-release-stage %}
|
||||
|
||||
You can enable the Tracks and Tracked-by fields on your projects to see the relationships between your issues as you add subtasks in Tasklists. For more information about creating issue hierarchies in Tasklists, see "[About Tasklists](/issues/tracking-your-work-with-issues/about-tasklists)."
|
||||
You can enable the Tracks and Tracked by fields on your projects to see the relationships between your issues as you add subtasks in Tasklists. For more information about creating issue hierarchies in Tasklists, see "[About Tasklists](/issues/tracking-your-work-with-issues/about-tasklists)."
|
||||
|
||||
The Tracked-by field can be used to group items, creating a view that clearly shows the subtasks of each issue and the work required to complete them. For more information, see "[Grouping by field values in table layout](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view#grouping-by-field-values-in-table-layout)."
|
||||
The Tracked by field can be used to group items, creating a view that clearly shows the subtasks of each issue and the work required to complete them. For more information, see "[Grouping by field values in table layout](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view#grouping-by-field-values-in-table-layout)."
|
||||
|
||||
You can also filter by the Tracked-by field to display only items that are tracked by specific issues. Either start typing "tracked-by" and select an issue from the list or, if you know the repository and issue number, you can type the filter below in full.
|
||||
You can also filter by the Tracked by field to display only items that are tracked by specific issues. Either start typing "tracked-by" and select an issue from the list or, if you know the repository and issue number, you can type the filter below in full.
|
||||
|
||||
```
|
||||
tracked-by:"<OWNER>/<REPO>#<ISSUE NUMBER>"
|
||||
@@ -24,9 +24,9 @@ tracked-by:"<OWNER>/<REPO>#<ISSUE NUMBER>"
|
||||
|
||||
To use the filter, replace `<OWNER>` with the repository owner, `<REPO>` with the repository name, and `<ISSUE NUMBER>` with the issue number. For more information, see "[Filtering projects](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)."
|
||||
|
||||
### Enabling the Tracked-by field
|
||||
### Enabling the Tracked by field
|
||||
|
||||
You can enable the Tracked-by field to see which issues are tracking an item in your project.
|
||||
You can enable the Tracked by field to see which issues are tracking an item in your project.
|
||||
|
||||
1. In table view, in the rightmost field header, click {% octicon "plus" aria-label="the plus icon" %}.
|
||||
|
||||
|
||||
@@ -22,21 +22,11 @@ The issues you add to your Tasklists will be automatically populated to show the
|
||||
|
||||
### About integration with {% data variables.projects.projects_v2 %}
|
||||
|
||||
Your project's side-panel displays an issue's place in the hierarchy on a breadcrumb menu, allowing you to navigate through the issues included in your Tasklists. You can also add the Tracks and Tracked-by fields to your project views to quickly see the relationships between your issues. For information, see "[About tracks and tracked-by fields](/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields)."
|
||||
Your project's side-panel displays an issue's place in the hierarchy on a breadcrumb menu, allowing you to navigate through the issues included in your Tasklists. You can also add the Tracks and Tracked by fields to your project views to quickly see the relationships between your issues. For information, see "[About tracks and tracked by fields](/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields)."
|
||||
|
||||
## Creating Tasklists
|
||||
|
||||
To create a Tasklist, you can either use the "Add Tasklist" button or edit the issue Markdown.
|
||||
|
||||
### Creating a Tasklist using the "Add Tasklist" button
|
||||
|
||||
Click the **{% octicon "checklist" aria-label="The checklist icon" %} Add Tasklist** button at the bottom of any issue description that you can edit to create a task list.
|
||||
|
||||
|
||||
|
||||
### Creating a Tasklist using Markdown
|
||||
|
||||
You can use Markdown in an issue description to create a Tasklist. Create a fenced code block and include `[tasklist]` next to the opening backticks. Preface each item with `- [ ]` and include links to other issues or text. You can optionally include a title as a Markdown header at the top of your list.
|
||||
You can create a Tasklist using Markdown in an issue description. Create a fenced code block and include `[tasklist]` next to the opening backticks. You can then preface each item with `- [ ]` and include links to other issues or text. You can optionally include a title as a Markdown header at the top of your list.
|
||||
|
||||
````
|
||||
```[tasklist]
|
||||
@@ -45,10 +35,11 @@ You can use Markdown in an issue description to create a Tasklist. Create a fenc
|
||||
- [ ] Draft issue title
|
||||
```
|
||||
````
|
||||
|
||||
Your Markdown will be rendered by {% data variables.product.product_name %} as a Tasklist. You can then make changes and add issues and draft issues using the UI. If you edit the issue description, you will be able to modify the Markdown directly or copy the Markdown to duplicate the Tasklist in other issues.
|
||||
|
||||
You can also click {% octicon "checklist" aria-label="The checklist icon" %} in the formatting toolbar to insert a Tasklist when creating a new issue or editing an issue description.
|
||||
|
||||
|
||||
|
||||
## Adding issues to a Tasklist
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{% note %}
|
||||
|
||||
**Note:** Tasklists and the tracks and tracked-by fields for Projects are currently in private beta and subject to change. If you are interested in trying Tasklists and using the new fields, you can join the [waitlist](https://aka.ms/tasklist-roadmap-signup).
|
||||
**Note:** Tasklists and the tracks and tracked by fields for Projects are currently in private beta and subject to change. If you are interested in trying Tasklists and using the new fields, you can join the [waitlist](https://aka.ms/tasklist-roadmap-signup).
|
||||
|
||||
{% endnote %}
|
||||
Reference in New Issue
Block a user