Skip to content

Commit ab78e7e

Browse files
committed
prereqs standardized
1 parent d93ddd3 commit ab78e7e

35 files changed

+209
-248
lines changed

docs/boards/backlogs/add-link.md

+14-14
Original file line numberDiff line numberDiff line change
@@ -24,33 +24,33 @@ Work item links are associations between two work items or a work item and anoth
2424

2525
::: moniker range=" azure-devops"
2626

27-
| Prerequisite | Description |
27+
| Category | Requirements |
2828
|:-------------|:------------|
29-
| **Project Administrator or Contributor member** | [Project member](../../organizations/security/add-users-team-project.md) and member of the **Contributors** or **Project Administrators** security group. |
30-
| **Stakeholder access** | To add or modify work items, have at least [**Stakeholder** access](../../organizations/security/stakeholder-access.md). Users with **Stakeholder** access for public projects have full access to backlog and board features, like users with **Basic** access. For more information, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md). |
31-
| **Contributor member or Allow permissions** | - To view or modify work items, have your **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set to **Allow**. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md).</br>- To configure the integration options for a Classic release pipeline, have permissions to edit the release.</br>- To link work items to commits and pull requests, have your **Edit work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. By default, the Contributors group has this permission set.</br>- To view work items, have your **View work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. |
32-
| **Defined iterations** | To use the **Planning** pane, your team administrator must [define iteration (sprint) paths and configure team iterations](../../organizations/settings/set-iteration-paths-sprints.md). |
29+
| **Project access** | [Project member](../../organizations/security/add-users-team-project.md). |
30+
| **Permissions** | - Member of the **Contributors** or **Project Administrators** security group.<br> - To view or modify work items: **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set to **Allow**. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md). <br> - To configure the integration options for a Classic release pipeline: **Edit** permissions for the release. <br> - To link work items to commits and pull requests: **Edit work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. By default, the Contributors group has this permission. <br> - To view work items: **View work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. |
31+
|**Access levels** | To add or modify work items: At least [**Stakeholder** access](../../organizations/security/stakeholder-access.md). Users with **Stakeholder** access for public projects have full access to backlog and board features, like users with **Basic** access. For more information, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md). |
32+
| **Defined iterations** | To use the **Planning** pane, your team administrator [defined iteration (sprint) paths and configured team iterations](../../organizations/settings/set-iteration-paths-sprints.md). |
3333

3434
::: moniker-end
3535

3636
::: moniker range=">= azure-devops-2020 < azure-devops"
3737

38-
| Prerequisite | Description |
38+
| Category | Requirements |
3939
|:-------------|:------------|
40-
| **Project Administrator or Contributor member** | [Project member](../../organizations/security/add-users-team-project.md) and member of the **Contributors** or **Project Administrators** security group. |
41-
| **Stakeholder access** | To add or modify work items, have at least [**Stakeholder** access](../../organizations/security/stakeholder-access.md). |
42-
| **Contributor member or Allow permissions** | - To view or modify work items, have your **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set to **Allow**. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md).<br>- To configure the integration options for a Classic release pipeline, have permissions to edit the release.<br>- To link work items to commits and pull requests, have your **Edit work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. By default, the Contributors group has this permission set.<br>- To view work items, have your **View work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. |
43-
| **Defined iterations** | To use the **Planning** pane, your team administrator must [define iteration (sprint) paths and configure team iterations](../../organizations/settings/set-iteration-paths-sprints.md). |
40+
| **Project access** | [Project member](../../organizations/security/add-users-team-project.md). |
41+
| **Permissions** | - Member of the **Contributors** or **Project Administrators** security group.<br> - To view or modify work items: **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set to **Allow**. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md). <br> - To configure the integration options for a Classic release pipeline: **Edit** permissions for the release. <br> - To link work items to commits and pull requests: **Edit work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. By default, the Contributors group has this permission. <br> - To view work items: **View work items in this node** permissions set to **Allow** for the Area Path assigned to the work item. |
42+
|**Access levels** | To add or modify work items: At least [**Stakeholder** access](../../organizations/security/stakeholder-access.md). Users with **Stakeholder** access for public projects have full access to backlog and board features, like users with **Basic** access. For more information, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md). |
43+
| **Defined iterations** | To use the **Planning** pane, your team administrator [defined iteration (sprint) paths and configured team iterations](../../organizations/settings/set-iteration-paths-sprints.md). |
4444

4545
::: moniker-end
4646

4747
::: moniker range="< azure-devops-2020"
4848

49-
| Prerequisite | Description |
49+
| Category | Requirements |
5050
|:-------------|:------------|
51-
| **Project Administrator or Contributor member** | [Project member](../../organizations/security/add-users-team-project.md) and member of the **Contributors** or **Project Administrators** security group. |
52-
| **Stakeholder access** | To add or modify work items, have at least [**Stakeholder** access](../../organizations/security/stakeholder-access.md). |
53-
| **Contributor member or Allow permissions** | To view or modify work items, have your **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set to **Allow**. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md). |
51+
| **Project access** | [Project member](../../organizations/security/add-users-team-project.md). |
52+
| **Permissions** | - Member of the **Contributors** or **Project Administrators** security group.<br> - To view or modify work items: **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set to **Allow**. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md).|
53+
| **Access levels** | - To add or modify work items: At least [**Stakeholder** access](../../organizations/security/stakeholder-access.md). |
5454
| **Defined iterations** | To use the **Planning** pane, your team administrator must [define iteration (sprint) paths and configure team iterations](../../organizations/settings/set-iteration-paths-sprints.md). |
5555

5656
::: moniker-end

docs/boards/backlogs/automate-work-item-state-transitions.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,17 @@ Rules are established at the team backlog level and are applicable to all work i
2626

2727
::: moniker range="azure-devops"
2828

29-
**Permissions:** To configure work item automation rules for your team, be a [Team Administrator](../../organizations/settings/add-team-administrator.md) or member of the [**Project Administrators**](../../organizations/security/change-project-level-permissions.md) group.
29+
| Category | Requirements |
30+
|:-------------|:------------|
31+
|**Permissions**| To configure work item automation rules for your team: [Team Administrator](../../organizations/settings/add-team-administrator.md) role or member of the [**Project Administrators**](../../organizations/security/change-project-level-permissions.md) group.|
3032

3133
::: moniker-end
3234

3335
::: moniker range="< azure-devops"
3436

35-
**Permissions:** To configure team settings, be a [Team Administrator](../../organizations/settings/add-team-administrator.md) or member of the [**Project Administrators**](../../organizations/security/change-project-level-permissions.md) group.
37+
| Category | Requirements |
38+
|:-------------|:------------|
39+
|**Permissions**| To configure team settings: [Team Administrator](../../organizations/settings/add-team-administrator.md) role or member of the [**Project Administrators**](../../organizations/security/change-project-level-permissions.md) group.|
3640

3741
::: moniker-end
3842

docs/boards/backlogs/configure-your-backlog-view.md

+6-5
Original file line numberDiff line numberDiff line change
@@ -30,11 +30,12 @@ To maximize the effectiveness of your backlog management, it's crucial to config
3030

3131
## Prerequisites
3232

33-
- **Project access**: Be a [project member](../../organizations/security/add-users-team-project.md)
34-
- **Permissions**: Be a member of the **Contributors** group.
35-
- **Access levels**:
36-
- To reorder a backlog or use the Forecast tool, have at least **Basic** access. Users with **Stakeholder** access can't reorder backlog items or use the Forecast tool. For more information, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md).
37-
- **Configured backlogs**: Ensure that both product and portfolio backlogs are set up for your team.
33+
| Category | Requirements |
34+
|--------------|-------------|
35+
| **Project access** | [Project member](../../organizations/security/add-users-team-project.md). |
36+
| **Permissions** | Member of the **Contributors** group. |
37+
| **Access levels** | - To reorder a backlog or use the Forecast tool: At least **Basic** access. Users with **Stakeholder** access can't reorder backlog items or use the Forecast tool. For more information, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md). |
38+
| **Configured backlogs** | Both product and portfolio backlogs set up for your team. |
3839

3940
> [!TIP]
4041
> You can't sort your backlog directly by clicking on a column header. To view a sorted list, select **Create query** from your backlog. Save and open the query, then modify it to a flat list query if needed to apply sorting to the results. For more information about queries, see [Use the query editor to list and manage queries](../queries/using-queries.md).

docs/boards/backlogs/connect-work-items-to-git-dev-ops.md

+11-9
Original file line numberDiff line numberDiff line change
@@ -48,20 +48,22 @@ From the **Development** control, you can quickly access branches, pull requests
4848

4949
::: moniker range="azure-devops"
5050

51-
- **Project access**: Be a [project member](../../organizations/security/add-users-team-project.md)
52-
- **Permissions**:
53-
- Be a member of the **Contributors** or **Project Administrators** group. To get added, [Add users to a project or team](../../organizations/security/add-users-team-project.md) group.
54-
- To view or modify work items, have your **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md).
55-
- **Access levels**: To reorder a backlog or use the Forecast tool, have at least **Basic** access. Users with **Stakeholder** access can't reorder backlog items or use the Forecast tool. For more information, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md).
51+
| Category | Requirements |
52+
|--------------|-------------|
53+
| **Project access** | [Project member](../../organizations/security/add-users-team-project.md). |
54+
| **Permissions** | Member of the **Contributors** or [**Project Administrators**](../../organizations/security/add-users-team-project.md) group. |
55+
| **Access levels** | - To view or modify work items: **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md). |
56+
|**Access levels** |To reorder a backlog or use the Forecast tool: At least **Basic** access. Users with **Stakeholder** access can't reorder backlog items or use the Forecast tool. For more information, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md). |
5657

5758
::: moniker-end
5859

5960
::: moniker range="< azure-devops"
6061

61-
- **Project access**: Be a [project member](../../organizations/security/add-users-team-project.md)
62-
- **Permissions**:
63-
- Be a member of the **Contributors** or **Project Administrators** group. To get added, [Add users to a project or team](../../organizations/security/add-users-team-project.md) group.
64-
- To view or modify work items, have your **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md).
62+
| Category | Requirements |
63+
|--------------|-------------|
64+
| **Project access** | [Project member](../../organizations/security/add-users-team-project.md). |
65+
| **Permissions** | Member of the **Contributors** or [**Project Administrators**](../../organizations/security/add-users-team-project.md) group. |
66+
| **Access levels** | - To view or modify work items: **View work items in this node** and **Edit work items in this node** permissions set to **Allow**. By default, the **Contributors** group has this permission set. For more information, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md). |
6567

6668
::: moniker-end
6769

docs/boards/backlogs/delete-test-artifacts.md

+5-7
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Test artifacts such as test plans, test suites, and test cases are all considere
2222
> [!IMPORTANT]
2323
> **Permanent and Irreversible Deletion:** Azure DevOps only supports the permanent deletion of test artifacts, including test plans, test suites, test cases, shared steps, and shared parameters. Deleted artifacts cannot be restored, and all associated child items, such as test results, are also removed. Additionally, bulk deletion of test artifacts is not supported; attempting to bulk delete results in the deletion of all other selected work items except the test artifacts.
2424
>
25-
> **Ensure you back up any necessary information before deleting test artifacts, as this action cannot be undone.**
25+
> **Back up any necessary information before deleting test artifacts, as this action cannot be undone.**
2626
2727
When you delete test artifacts, the following actions occur:
2828

@@ -40,12 +40,10 @@ When you delete test artifacts, the following actions occur:
4040

4141
## Prerequisites
4242

43-
- **Permissions**:
44-
- To delete test runs, be a member of the **Project Administrators** group or have the project-level [**Delete test runs**](../../organizations/security/change-project-level-permissions.md) permission set to **Allow**.
45-
- To delete test plans and test suites, be a member of the **Project Administrators** group or have the Area Path node-level [**Manage test plans** or **Manage test suites**](../../organizations/security/set-permissions-access-work-tracking.md#manage-test-artifacts) permission set to **Allow**. If the user isn't part of the project administrator group, then the user must have project-level [**Delete test runs**](../../organizations/security/change-project-level-permissions.md) permission set to **Allow** along with Area Path node level permissions.
46-
- **Access levels**: To manage or delete test artifacts, have at least [**Basic + Test Plans**](../../organizations/security/access-levels.md) access or **Visual Studio Enterprise**. This level provides access to the full Test Plans feature set. Users with **Basic** access and with permissions to permanently delete work items and manage test artifacts can only delete orphaned test cases, which means they can delete test cases created from **Work** that aren't linked to any test plans or test suites.
47-
48-
::: moniker-end
43+
| Category | Requirements |
44+
|--------------|-------------|
45+
| **Permissions** | - To delete test runs: Member of the **Project Administrators** group or the project-level [**Delete test runs**](../../organizations/security/change-project-level-permissions.md) permission set to **Allow**. <br> - To delete test plans and test suites: Member of the **Project Administrators** group or the Area Path node-level [**Manage test plans** or **Manage test suites**](../../organizations/security/set-permissions-access-work-tracking.md#manage-test-artifacts) permission set to **Allow**. If you're not part of the project administrators group: Project-level [**Delete test runs**](../../organizations/security/change-project-level-permissions.md) permission set to **Allow** along with Area Path node level permissions. |
46+
| **Access levels** | To manage or delete test artifacts: At least [**Basic + Test Plans**](../../organizations/security/access-levels.md) access or **Visual Studio Enterprise**. This level provides access to the full Test Plans feature set. Users with **Basic** access and with permissions to permanently delete work items and manage test artifacts can only delete orphaned test cases, which means they can delete test cases created from **Work** that aren't linked to any test plans or test suites. |
4947

5048
<a id="test-experience"></a>
5149

0 commit comments

Comments
 (0)