Add latest changes from gitlab-org/gitlab@master

1 files changed, 84 insertions, 56 deletions

diff --git a/doc/user/project/issue_board.md b/doc/user/project/issue_board.md
index 787e990526d..3e980717313 100644
--- a/doc/user/project/issue_board.md
+++ b/doc/user/project/issue_board.md
@@ -8,14 +8,15 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 
 The issue board is a software project management tool used to plan,
 organize, and visualize a workflow for a feature or product release.
-It can be used as a [Kanban](https://en.wikipedia.org/wiki/Kanban_(development)) or a
+
+You can use it as a [Kanban](https://en.wikipedia.org/wiki/Kanban_(development)) or a
 [Scrum](https://en.wikipedia.org/wiki/Scrum_(software_development)) board.
 
-It pairs issue tracking and project management, keeping everything together,
-so that you don't need to jump between different platforms to organize your workflow.
+Issue boards pair issue tracking and project management, keeping everything together,
+so you can organize your workflow on a single platform.
 
-Issue boards build on the existing [issue tracking functionality](issues/index.md) and
-[labels](labels.md). Your issues appear as cards in vertical lists, organized by their assigned
+Issue boards use [issues](issues/index.md) and [labels](labels.md).
+Your issues appear as cards in vertical lists, organized by their assigned
 labels, [milestones](#milestone-lists), or [assignees](#assignee-lists).
 
 Issue boards help you to visualize and manage your entire process in GitLab.
@@ -31,21 +32,20 @@ boards in the same project.
 
 ![GitLab issue board - Core](img/issue_boards_core_v14_1.png)
 
-Different issue board features are available in different [GitLab tiers](https://about.gitlab.com/pricing/),
-as shown in the following table:
+Different issue board features are available in different [GitLab tiers](https://about.gitlab.com/pricing/):
 
 | Tier     | Number of project issue boards | Number of [group issue boards](#group-issue-boards) | [Configurable issue boards](#configurable-issue-boards) | [Assignee lists](#assignee-lists) |
 | -------- | ------------------------------ | --------------------------------------------------- | ------------------------------------------------------- | --------------------------------- |
-| Free     | Multiple                       | 1                                                   | No                                                      | No                                |
-| Premium  | Multiple                       | Multiple                                            | Yes                                                     | Yes                               |
-| Ultimate | Multiple                       | Multiple                                            | Yes                                                     | Yes                               |
+| Free     | Multiple                       | 1                                                   | **{dotted-circle}** No                                  | **{dotted-circle}** No            |
+| Premium  | Multiple                       | Multiple                                            | **{check-circle}** Yes                                  | **{check-circle}** Yes            |
+| Ultimate | Multiple                       | Multiple                                            | **{check-circle}** Yes                                  | **{check-circle}** Yes            |
 
-To learn more, visit [GitLab Enterprise features for issue boards](#gitlab-enterprise-features-for-issue-boards) below.
+Read more about [GitLab Enterprise features for issue boards](#gitlab-enterprise-features-for-issue-boards).
 
 ![GitLab issue board - Premium](img/issue_boards_premium_v14_1.png)
 
 <i class="fa fa-youtube-play youtube" aria-hidden="true"></i>
-Watch a [video presentation](https://youtu.be/vjccjHI7aGI) of
+Watch a [video presentation](https://youtu.be/vjccjHI7aGI) (April 2020) of
 the issue board feature.
 
 ## Multiple issue boards
@@ -68,17 +68,25 @@ GitLab automatically loads the last board you visited.
 
 ### Create an issue board
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 To create a new issue board:
 
-1. Select the dropdown with the current board name in the upper left corner of the issue boards page.
+1. Select the dropdown list with the current board name in the upper left corner of the issue boards page.
 1. Select **Create new board**.
 1. Enter the new board's name and select its scope: milestone, labels, assignee, or weight.
 
 ### Delete an issue board
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 To delete the currently active issue board:
 
-1. Select the dropdown with the current board name in the upper left corner of the issue boards page.
+1. Select the dropdown list with the current board name in the upper left corner of the issue boards page.
 1. Select **Delete board**.
 1. Select **Delete** to confirm.
 
@@ -192,12 +200,11 @@ card includes:
 - Issue number
 - Assignee
 
-## Permissions
+## Ordering issues in a list
 
-Users with at least the Reporter role can use all the functionality of the
-issue board feature to create or delete lists. They can also drag issues from one list to another.
+Prerequisites:
 
-## Ordering issues in a list
+- You must have at least the Reporter role for the project.
 
 When an issue is created, the system assigns a relative order value that is greater than the maximum value
 of that issue's project or root group. This means the issue will be at the bottom of any issue list that
@@ -275,16 +282,19 @@ Users on GitLab Free can use a single group issue board.
 
 ### Assignee lists **(PREMIUM)**
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/5784) in GitLab 11.0.
-
 As in a regular list showing all issues with a chosen label, you can add
 an assignee list that shows all issues assigned to a user.
-You can have a board with both label lists and assignee lists. To add an
-assignee list:
+You can have a board with both label lists and assignee lists.
+
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
+To add an assignee list:
 
 1. Select **Create list**.
 1. Select **Assignee**.
-1. In the dropdown, select a user.
+1. In the dropdown list, select a user.
 1. Select **Add to board**.
 
 Now that the assignee list is added, you can assign or unassign issues to that user
@@ -295,14 +305,18 @@ To remove an assignee list, just as with a label list, select the trash icon.
 
 ### Milestone lists **(PREMIUM)**
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/6469) in GitLab 11.2.
-
 You're also able to create lists of a milestone. These are lists that filter issues by the assigned
-milestone, giving you more freedom and visibility on the issue board. To add a milestone list:
+milestone, giving you more freedom and visibility on the issue board.
+
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
+To add a milestone list:
 
 1. Select **Create list**.
 1. Select **Milestone**.
-1. In the dropdown, select a milestone.
+1. In the dropdown list, select a milestone.
 1. Select **Add to board**.
 
 Like the assignee lists, you're able to [drag issues](#move-issues-and-lists)
@@ -316,14 +330,17 @@ As in other list types, select the trash icon to remove a list.
 > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/250479) in GitLab 13.11 [with a flag](../../administration/feature_flags.md) named `iteration_board_lists`. Enabled by default.
 > - [Generally available](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/75404) in GitLab 14.6. Feature flag `iteration_board_lists` removed.
 
-You're also able to create lists of an iteration.
-These lists filter issues by the assigned iteration.
+You can create lists of issues in an iteration.
+
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
 
 To add an iteration list:
 
 1. Select **Create list**.
 1. Select **Iteration**.
-1. In the dropdown, select an iteration.
+1. In the dropdown list, select an iteration.
 1. Select **Add to board**.
 
 Like the milestone lists, you're able to [drag issues](#move-issues-and-lists)
@@ -344,9 +361,13 @@ This feature is available both at the project and group level.
 <i class="fa fa-youtube-play youtube" aria-hidden="true"></i>
 For a video overview, see [Epics Swimlanes Walkthrough - 13.6](https://www.youtube.com/watch?v=nHC7-kz5P2g) (November 2020).
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 To group issues by epic in an issue board:
 
-1. Select the **Group by** dropdown button.
+1. Select **Group by**.
 1. Select **Epic**.
 
 ![Epics Swimlanes](img/epics_swimlanes_v14_1.png)
@@ -375,8 +396,7 @@ You can also [drag issues](#move-issues-and-lists) to change their position and
 
 ## Work In Progress limits **(PREMIUM)**
 
-> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/11403) in GitLab 12.7
-> - Moved to GitLab Premium in 13.9.
+> Moved to GitLab Premium in 13.9.
 
 You can set a Work In Progress (WIP) limit for each issue list on an issue board. When a limit is
 set, the list's header shows the number of issues in the list and the soft limit of issues.
@@ -389,6 +409,10 @@ Examples:
 - You have a list with five issues with a limit of five. When you move another issue to that list,
   the list's header displays **6/5**, with the six shown in red.
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 To set a WIP limit for a list:
 
 1. Navigate to a Project or Group board of which you're a member.
@@ -399,8 +423,7 @@ To set a WIP limit for a list:
 
 ## Blocked issues **(PREMIUM)**
 
-> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/34723) in GitLab 12.8.
-> - [View blocking issues when hovering over blocked icon](https://gitlab.com/gitlab-org/gitlab/-/issues/210452) in GitLab 13.10.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/210452) in GitLab 13.10: View blocking issues when hovering over the "blocked" icon.
 
 If an issue is [blocked by another issue](issues/related_issues.md#blocking-issues), an icon appears next to its title to indicate its blocked
 status.
@@ -423,9 +446,6 @@ When you hover over the blocked icon (**{issue-block}**), a detailed information
 - Change issue labels (by dragging an issue between lists).
 - Close an issue (by dragging it to the **Closed** list).
 
-If you're not able to do some of the things above, make sure you have the right
-[permissions](#permissions).
-
 ### Edit an issue
 
 > Editing title, iteration, and confidentiality [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/248908) in GitLab 14.1.
@@ -433,6 +453,10 @@ If you're not able to do some of the things above, make sure you have the right
 You can edit an issue without leaving the board view.
 To open the right sidebar, select an issue card (not its title).
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 You can edit the following issue attributes in the right sidebar:
 
 - Assignees
@@ -462,6 +486,10 @@ at the end of the lists, before **Closed**. To move and reorder lists, drag them
 Removing a list doesn't have any effect on issues and labels, as it's just the
 list view that's removed. You can always create it again later if you need.
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 To remove a list from an issue board:
 
 1. On the top of the list you want to remove, select the **List settings** icon (**{settings}**).
@@ -473,6 +501,10 @@ To remove a list from an issue board:
 
 > The **Add issues** button was [removed](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/57329) in GitLab 13.11.
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 If your board is scoped to one or more attributes, go to the issues you want to add and apply the
 same attributes as your board scope.
 
@@ -488,6 +520,11 @@ The issue should now show in the `Doing` list on your issue board.
 > The **Remove from board** button was [removed](https://gitlab.com/gitlab-org/gitlab/-/issues/229507) in GitLab 13.10.
 
 When an issue should no longer belong to a list, you can remove it.
+
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 The steps depend on the scope of the list:
 
 1. To open the right sidebar, select the issue card.
@@ -502,6 +539,10 @@ The steps depend on the scope of the list:
 You can use the filters on top of your issue board to show only
 the results you want. It's similar to the filtering used in the [issue tracker](issues/index.md).
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 You can filter by the following:
 
 - Assignee
@@ -593,8 +634,7 @@ and the target list.
 
 ### Multi-select issue cards
 
-> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/18954) in GitLab 12.4.
-> - [Placed](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/61955) behind a [feature flag](../feature_flags.md), disabled by default in GitLab 14.0.
+> [Moved](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/61955) behind a [feature flag](../feature_flags.md) named `board_multi_select` in GitLab 14.0. Disabled by default.
 
 FLAG:
 On self-managed GitLab, by default this feature is not available. To make it available, ask an
@@ -605,6 +645,10 @@ The feature is not ready for production use.
 You can select multiple issue cards, then drag the group to another position within the list, or to
 another list. This makes it faster to reorder many issues at once.
 
+Prerequisites:
+
+- You must have at least the Reporter role for the project.
+
 To select and move multiple cards:
 
 1. Select each card with <kbd>Control</kbd>+`Click` on Windows or Linux, or <kbd>Command</kbd>+`Click` on MacOS.
@@ -612,22 +656,6 @@ To select and move multiple cards:
 
 ![Multi-select Issue Cards](img/issue_boards_multi_select_v12_4.png)
 
-### First time using an issue board
-
-> - The automatic creation of the **To Do** and **Doing** lists [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/202144) in GitLab 13.5.
-> - [Deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/270583) in GitLab 13.7. In GitLab 13.7 and later, the **To Do** and **Doing** columns are not automatically created.
-
-WARNING:
-This feature was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/270583) in GitLab 13.7.
-The **To Do** and **Doing** columns are no longer automatically created.
-
-In GitLab 13.5 and 13.6, the first time you open an issue board, you are presented with the default lists
-(**Open**, **To Do**, **Doing**, and **Closed**).
-
-If the **To Do** and **Doing** labels don't exist in the project or group, they are created, and
-their lists appear as empty. If any of them already exists, the list is filled with the issues that
-have that label.
-
 ## Tips
 
 A few things to remember: