Commit d460143f authored by Marcin Sedlak-Jakubowski's avatar Marcin Sedlak-Jakubowski Committed by Fiona Neill

Enhance sorting issue lists doc

parent 496719fd
......@@ -8,34 +8,59 @@ info: To determine the technical writer assigned to the Stage/Group associated w
You can sort a list of issues several ways, including by:
- Blocking **(PREMIUM)**
- Created date
- Due date
- Label priority
- Last updated
- Milestone due date
- Popularity
- Priority
- Title ([introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/67234) in GitLab 14.3)
- Weight
- [Blocking issues](#sorting-by-blocking-issues)
- [Created date](#sorting-by-created-date)
- [Due date](#sorting-by-due-date)
- [Label priority](#sorting-by-label-priority)
- [Last updated](#sorting-by-last-updated)
- [Manual sorting](#manual-sorting)
- [Milestone due date](#sorting-by-milestone-due-date)
- [Popularity](#sorting-by-popularity)
- [Priority](#sorting-by-priority)
- [Title](#sorting-by-title)
- [Weight](#sorting-by-weight)
The available sorting options can change based on the context of the list.
For sorting by issue priority, see [Label Priority](../labels.md#label-priority).
In group and project issue lists, it is also possible to order issues manually,
similar to [issue boards](../issue_board.md#ordering-issues-in-a-list).
## Sorting by blocking issues **(PREMIUM)**
## Sorting by popularity
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/34247/) in GitLab 13.7.
When you select sorting by **Popularity**, the issue order changes to sort descending by the
number of upvotes ([awarded](../../award_emojis.md) "thumbs up" emoji)
on each issue. You can use this to identify issues that are in high demand.
When you sort by **Blocking**, the issue list changes to sort descending by the
number of issues each issue is blocking.
## Sorting by created date
When you sort by **Created date**, the issue list changes to sort descending by the issue
creation date. Issues created most recently are first.
## Sorting by due date
When you sort by **Due date**, the issue list changes to sort ascending by the issue
[due date](issue_data_and_actions.md#due-date). Issues with the earliest due date are first,
and issues without a due date are last.
## Sorting by label priority
When you sort by **Label priority**, the issue list changes to sort descending.
Issues with the highest priority label are first, then all other issues.
Ties are broken arbitrarily. Only the highest prioritized label is checked,
and labels with a lower priority are ignored.
For more information, see [issue 14523](https://gitlab.com/gitlab-org/gitlab/-/issues/14523).
To learn more about priority labels, read the [Labels](../labels.md#label-priority) documentation.
## Sorting by last updated
When you sort by **Last updated**, the issue list changes to sort by the time of a last
update. Issues changed the most recently are first.
## Manual sorting
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62178) in GitLab 12.2.
When you select **Manual** sorting, you can change
When you sort by **Manual** order, you can change
the order by dragging and dropping the issues. The changed order persists, and
everyone who visits the same list sees the updated issue order, with some exceptions.
......@@ -50,11 +75,45 @@ this ordering is maintained whenever they appear together in any list.
This ordering also affects [issue boards](../issue_board.md#ordering-issues-in-a-list).
Changing the order in an issue list changes the ordering in an issue board,
and vice versa.
and the other way around.
## Sorting by blocking issues **(PREMIUM)**
## Sorting by milestone due date
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/34247/) in GitLab 13.7.
When you sort by **Milestone due date**, the issue list changes to sort ascending by the
assigned milestone due date. Issues with milestones with the earliest due date are first,
then issues with a milestone without a due date.
## Sorting by popularity
When you sort by **Popularity**, the issue order changes to sort descending by the
number of upvotes ([awarded](../../award_emojis.md) a "thumbs up" emoji)
on each issue. You can use this to identify issues that are in high demand.
## Sorting by priority
When you sort by **Priority**, the issue order changes to sort in this order:
1. Issues with milestones that have due dates, where the soonest assigned milestone is listed first.
1. Issues with milestones with no due dates.
1. Issues with a higher priority label.
1. Issues without a prioritized label.
To learn more about priority, read the [Labels](../labels.md#label-priority) documentation.
## Sorting by title
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/67234) in GitLab 14.3.
When you sort by **Title**, the issue order changes to sort alphabetically by the issue
title in this order:
- Emoji
- Special characters
- Numbers
- Letters: first Latin, then accented (for example, `ö`)
## Sorting by weight
When you select to sort by **Blocking**, the issue list changes to sort descending by the
number of issues each issue is blocking. You can use this to determine the critical path for your backlog.
When you sort by **Weight**, the issue list changes to sort ascending by the
[issue weight](issue_weight.md).
Issues with lowest weight are first, and issues without a weight are last.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment