diff options
Diffstat (limited to 'doc/user/tasks.md')
-rw-r--r-- | doc/user/tasks.md | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/doc/user/tasks.md b/doc/user/tasks.md index f4fec01d42b..347aedd6e74 100644 --- a/doc/user/tasks.md +++ b/doc/user/tasks.md @@ -443,3 +443,50 @@ The description and threads are on the left, and attributes, such as labels or assignees, on the right. ![Task two column view](img/task_two_column_view_v16_2.png) + +## Linked items in Tasks + +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/416558) in GitLab 16.5 [with a flag](../administration/feature_flags.md) named `linked_work_items`. Disabled by default. + +FLAG: +On self-managed GitLab, by default this feature is not available. To make it available, an administrator can [enable the feature flag](../administration/feature_flags.md) named `linked_work_items`. +On GitLab.com, this feature is not available. +This feature is not ready for production use. + +Linked items are a bi-directional relationship and appear in a block below +the emoji reactions section. You can link an objective, key result, or a task in the same project with each other. + +The relationship only shows up in the UI if the user can see both items. + +### Add a linked item + +Prerequisite: + +- You must have at least the Guest role for the project. + +To link an item to a task: + +1. In the **Linked items** section of a task, + select the **Add** button. +1. Select the relationship between the two items. Either: + - **relates to** + - **blocks** + - **is blocked by** +1. Enter the search text of the item. +1. When you have added all the items to be linked, select **Add** below the search box. + +When you have finished adding all linked items, you can see +them categorized so their relationships can be better understood visually. + +![Linked items block](img/linked_items_list_v16_5.png) + +### Remove a linked item + +Prerequisite: + +- You must have at least the Guest role for the project. + +In the **Linked items** section of a task, +next to each item, select the vertical ellipsis (**{ellipsis_v}**) and then select **Remove**. + +Due to the bi-directional relationship, the relationship no longer appears in either item. |