Skip to content

Commit d1587a9

Browse files
authored
Merge pull request #3850 from MicrosoftDocs/user/kaelli/misc-verbatim-fixes-10-13
User/kaelli/misc verbatim fixes 10 13
2 parents 6bb2b24 + b57451a commit d1587a9

13 files changed

+122
-101
lines changed

docs/boards/backlogs/filter-backlogs-boards-plans.md

+67-58
Original file line numberDiff line numberDiff line change
@@ -7,49 +7,60 @@ ms.technology: devops-agile
77
ms.author: kaelli
88
author: KathrynEE
99
ms.topic: how-to
10-
monikerRange: '<= azure-devops'
11-
ms.date: 10/08/2021
10+
monikerRange: '>= tfs-2015'
11+
ms.date: 10/13/2021
1212
---
1313

1414
# Interactively filter backlogs, boards, queries, and plans in Azure Boards
1515

16-
[!INCLUDE [temp](../includes/version-all.md)]
16+
[!INCLUDE [temp](../includes/version-vsts-tfs-2015-on.md)]
1717

1818
<a id="filter"></a>
1919

20-
With filter functions, you can interactively apply one or more filters to an Azure Boards tool. Each tool is already filtered to show a subset of work items according to the tool function. For example, Backlogs and Boards display work items based on the selected Area Paths and Iteration Paths for the team. Query Results list work items based on the query clauses you've defined.
20+
::: moniker range=">= tfs-2017"
2121

22+
With filter functions, you can interactively apply one or more filters to an Azure Boards tool. Each tool is already filtered to show a subset of work items according to the tool function. For example, Backlogs and Boards display work items based on the selected **Area Paths** and **Iteration Paths** for the team. **Query Results** list work items based on the query clauses you've defined.
23+
::: moniker-end
24+
::: moniker range=">= tfs-2017"
2225
You enable the filter feature by choosing :::image type="icon" source="../../media/icons/filter-icon.png" border="false"::: **Filter**.
26+
::: moniker-end
27+
::: moniker range=">=azure-devops-2019"
28+
:::image type="content" source="media/filter/filter-backlogs.png" alt-text="Screenshot of choosing Filter function latest versions.":::
29+
::: moniker-end
2330

24-
> [!div class="mx-imgBorder"]
25-
> ![Screenshot of choosing Filter function latest versions.](media/filter/filter-backlogs.png)
2631

32+
::: moniker range="tfs-2017 || tfs-2018"
33+
:::image type="content" source="media/filter/filter-backlogs-options-tfs-2017.png" alt-text="Screenshot of initial keyword filter function. ":::
34+
::: moniker-end
35+
36+
::: moniker range="tfs-2015"
37+
:::image type="content" source="media/filter/initial-keyword-filter-function.png" alt-text="Screenshot of initial keyword filter function. ":::
38+
::: moniker-end
2739

40+
::: moniker range=">= tfs-2017"
2841
From these tools, you may still have a large number of work items listed or displayed. Interactive filtering supports your ability to focus on a subset of them. You can apply one or more filter functions to each of the Azure Boards tools.
42+
::: moniker-end
2943

30-
::: moniker range="<= tfs-2015"
31-
You can use the keyword, ID, and tag filter functions with Boards, Backlogs, Sprint Backlogs, and Queries.
44+
::: moniker range="tfs-2015"
45+
With the filter function, you can interactively apply a keyword filters to an Azure Boards tool. Each tool is already filtered to show a subset of work items according to the tool function. For example, **Backlogs** and **Boards** display work items based on the selected **Area Paths** and **Iteration Paths** for the team. **Query Results** list work items based on the query clauses you've defined. You can use the filter function to filter work items based on a keyword, ID or tag.
3246
::: moniker-end
3347

3448
::: moniker range=">= tfs-2017"
3549

3650
Use filters to complete these tasks:
3751
- In daily scrum meetings, filter the Kanban board to focus on assigned work for a specific sprint.
3852
- Or, if your team uses the Sprints Taskboard, filter for a team member's completed assigned work.
39-
- To focus on a group of work items, filter based on the Parent Work Item, by Area Path, or Tags.
53+
- To focus on a group of work items, filter based on the **Parent Work Item**, by **Area Path**, or **Tags**.
4054
- To triage work items, create a query and filter to focus on similar work grouped by Area Path or Tags.
4155

4256

4357
::: moniker-end
4458

4559
::: moniker range=">= tfs-2017"
46-
4760
## Supported filter functions
48-
4961
::: moniker-end
5062

5163
::: moniker range=">= azure-devops-2019"
52-
5364
Filter functions are available from all Azure Boards tools: Work items, Boards, Backlogs, Sprint Backlogs and Taskboards, Queries, and Delivery Plans. The set of features supported depends on the tool and Azure DevOps version. *(Use the content selector to view the filters available for your version.)*
5465

5566
The following table indicates the supported options based on the tool indicated with a ✔️ or is listed.
@@ -58,7 +69,6 @@ Backlogs and boards are subject to filters defined for the team as described in
5869

5970
::: moniker-end
6071

61-
6272
::: moniker range=">= tfs-2017 <= tfs-2018"
6373

6474
Filter functions are available from all Azure Boards tools: Boards, Backlogs, Sprint Backlogs, Taskboards, and Queries. The set of features supported depends on the tool and Azure DevOps version. *(Use the content selector to view the filters available for your version.)*
@@ -77,7 +87,7 @@ Supported options are indicated with a ✔️ or listed.
7787
<br/>**Tool**
7888
:::column-end:::
7989
:::column span="1":::
80-
**Keywords**<br/>or **ID**
90+
**Keywords** or **ID**
8191
:::column-end:::
8292
:::column span="2":::
8393
<br/>**Fields**
@@ -137,7 +147,7 @@ Supported options are indicated with a ✔️ or listed.
137147
:::row-end:::
138148
---
139149
::: moniker-end
140-
::: moniker range=">= tfs-2017"
150+
::: moniker range=">= tfs-2018"
141151
:::row:::
142152
:::column span="1.5":::
143153
[**Backlogs**](backlogs-overview.md)
@@ -160,7 +170,31 @@ Supported options are indicated with a ✔️ or listed.
160170
:::row-end:::
161171
---
162172
::: moniker-end
163-
::: moniker range=">= tfs-2017"
173+
::: moniker range=">= azure-devops-2020"
174+
:::row:::
175+
:::column span="1.5":::
176+
[**Sprints** (Backlogs
177+
& Taskboards)](../sprints/scrum-overview.md)
178+
:::column-end:::
179+
:::column span="1":::
180+
✔️
181+
:::column-end:::
182+
:::column span="2":::
183+
- Assigned To
184+
- Work Item Type
185+
- States
186+
- Area Path
187+
:::column-end:::
188+
:::column span="1.5":::
189+
✔️ (Note 2)
190+
:::column-end:::
191+
:::column span="1":::
192+
✔️
193+
:::column-end:::
194+
:::row-end:::
195+
---
196+
::: moniker-end
197+
::: moniker range=">= tfs-2018 < azure-devops-2020"
164198
:::row:::
165199
:::column span="1.5":::
166200
[**Sprints** (Backlogs
@@ -176,15 +210,15 @@ Supported options are indicated with a ✔️ or listed.
176210
- Area Path
177211
:::column-end:::
178212
:::column span="1.5":::
179-
✔️
213+
180214
:::column-end:::
181215
:::column span="1":::
182-
✔️ (Note 2)
216+
✔️
183217
:::column-end:::
184218
:::row-end:::
185219
---
186220
::: moniker-end
187-
::: moniker range=">= tfs-2017"
221+
::: moniker range=">= tfs-2018"
188222
:::row:::
189223
:::column span="1.5":::
190224
[**Query Results**](../queries/view-run-query.md)
@@ -222,7 +256,6 @@ Supported options are indicated with a ✔️ or listed.
222256
- Area Path
223257
- Iteration Path
224258
- Tags
225-
- Parent Work Item
226259
:::column-end:::
227260
:::column span="1.5":::
228261
✔️
@@ -233,7 +266,7 @@ Supported options are indicated with a ✔️ or listed.
233266
:::row-end:::
234267
---
235268
::: moniker-end
236-
::: moniker range=">= tfs-2017 <= azure-devops-2020"
269+
::: moniker range=">= tfs-2018 <= azure-devops-2020"
237270
:::row:::
238271
:::column span="1.5":::
239272
[**Plans**](../extensions/delivery-plans.md)
@@ -281,7 +314,7 @@ Supported options are indicated with a ✔️ or listed.
281314
---
282315
::: moniker-end
283316

284-
::: moniker range=">= azure-devops-2020"
317+
::: moniker range=">= tfs-2017"
285318

286319
**Notes**
287320

@@ -290,8 +323,7 @@ Supported options are indicated with a ✔️ or listed.
290323

291324
::: moniker-end
292325

293-
294-
326+
295327

296328
::: moniker range=">= azure-devops-2020"
297329

@@ -479,29 +511,6 @@ Along with the standard filter functions summarized in the previous table, the f
479511
:::row-end:::
480512
---
481513
::: moniker-end
482-
::: moniker range=">= tfs-2017 <= azure-devops-2020"
483-
:::row:::
484-
:::column span="2":::
485-
[**Plans**](../extensions/delivery-plans.md)
486-
:::column-end:::
487-
:::column span="2":::
488-
489-
:::column-end:::
490-
:::column span="1":::
491-
492-
:::column-end:::
493-
:::column span="1":::
494-
✔️ (Note 6)
495-
:::column-end:::
496-
:::column span="1":::
497-
498-
:::column-end:::
499-
:::column span="1":::
500-
501-
:::column-end:::
502-
:::row-end:::
503-
---
504-
::: moniker-end
505514
::: moniker range=">= azure-devops-2020"
506515
:::row:::
507516
:::column span="2":::
@@ -801,12 +810,17 @@ Once you set the filter options for a specific view, your settings persist until
801810
- To filter using fields, first add the field as a column or to the card. For example, to filter by **Assign To**, **Iteration Path**, or **Work Item Type**&mdash;or the contents of any other field&mdash;add those fields to show on the cards, backlog, plan, or list.
802811

803812
To add columns or fields, see the following articles:
813+
::: moniker-end
814+
::: moniker range=">= azure-devops-2020"
804815
- For Backlogs and Queries, see [Change column options](set-column-options.md)
805816
- For Boards, see [Customize cards](../boards/customize-cards.md)
806817
- For Taskboards, see [Customize a sprint Taskboard](../sprints/customize-taskboard.md)
807818
- For Plans, see [Review team delivery plans]( ../plans/review-team-plans.md).
808819
::: moniker-end
809-
820+
::: moniker range=">= tfs-2017 < azure-devops-2020"
821+
- For Backlogs and Queries, see [Change column options](set-column-options.md)
822+
- For Boards, see [Customize cards](../boards/customize-cards.md).
823+
::: moniker-end
810824

811825
## Open and clear filter functions
812826

@@ -908,8 +922,6 @@ The filter criteria ignores the following characters when the field value starts
908922

909923
### Filter a board using a keyword
910924

911-
912-
913925
::: moniker range=">= azure-devops-2019"
914926

915927
Here we filter the Kanban board to only show those cards that include 'web', either in the title, tag, or field.
@@ -920,10 +932,8 @@ Here we filter the Kanban board to only show those cards that include 'web', eit
920932
::: moniker-end
921933

922934
::: moniker range=">= tfs-2017 < azure-devops-2019"
923-
924-
![Kanban board, Filter using keyword search, earlier versions.](media/filter-boards/filter-options-web.png)
925935
Here we filter the Kanban board to only show those cards that include 'Web', either in the title, tag, or displayed field.
926-
936+
![Kanban board, Filter using keyword search, earlier versions.](media/filter-boards/filter-options-web.png)
927937
::: moniker-end
928938

929939
::: moniker range="tfs-2015"
@@ -934,17 +944,16 @@ Here we filter the Kanban board to only show those cards that include 'web', eit
934944

935945
::: moniker-end
936946

937-
938-
### Filter a backlog by using a keyword
947+
::: moniker range=">= tfs-2017"
948+
## Filter a backlog by using a keyword
939949

940950
Here we filter the Backlog with **Show Parents** enabled, to only show work items that include 'web'.
941951

942952
> [!div class="mx-imgBorder"]
943953
> ![Backlog, Hierarchy, Filter using keyword search.](media/filter/filter-backlog-web-keyword.png)
944954
945-
946955
The filtered set is always a flat list, even if you've selected to show parents.
947-
956+
::: moniker-end
948957

949958
::: moniker range=">= tfs-2017"
950959

@@ -1083,7 +1092,7 @@ Check the boxes of those tags that you want to filter on. Keep the **OR** select
10831092
> ![Screenshot of filtering board based on tags, TFS 2017 and 2018 versions. ](../queries/media/add-tags/filter-backlog-tags.png)
10841093
::: moniker-end
10851094

1086-
::: moniker range="<= tfs-2015"
1095+
::: moniker range="tfs-2015"
10871096

10881097
1. Turn on filtering and choose a tag.
10891098

docs/boards/backlogs/manage-bugs.md

+10-3
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Manage code defects to maintain software quality in Azure Boards
33
titleSuffix: Azure Boards
4-
description: Define, capture, and triage software defects to manage technical debt and maintain software quality in Azure Boards.
4+
description: Define, capture, and triage software defects and bugs to manage technical debt and maintain software quality in Azure Boards.
55
ms.custom: "boards-backlogs, contperf-fy21q4-portal"
66
ms.technology: devops-agile
77
ms.assetid: 6E5710EE-21C8-4264-AD65-A827D186F134
@@ -31,10 +31,15 @@ Extra features for managing bugs include the following benefits:
3131
[!INCLUDE [temp](../includes/basic-process-bug-note.md)]
3232

3333

34+
[!INCLUDE [temp](../includes/prerequisites-work-items.md)]
35+
36+
> [!TIP]
37+
> To report a bug, a user must have at a minimum, **Stakeholder** access and **Edit work items in this node** permission set to **Allow** for the **Area Path** where they will add the bug. To learn more, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md)
38+
3439
## Bug work item type
3540

3641
The following image shows the Bug work item type for the Scrum process. The Bug work item type for Agile and CMMI processes tracks similar information. It's designed to appear on the product backlog along with requirements or on the Taskboard along with tasks.
37-
42+
3843
[!INCLUDE [temp](../includes/image-differences-with-wits.md)]
3944

4045
::: moniker range=">= azure-devops-2020"
@@ -50,16 +55,18 @@ The following image shows the Bug work item type for the Scrum process. The Bug
5055
![Bug work item type, form for Scrum process, TFS 2013 and TFS 2015 versions.](media/scrum-bug-wi-form.png)
5156
::: moniker-end
5257

58+
59+
5360
::: moniker range=">= tfs-2017"
5461
> [!TIP]
5562
> Use the [Discussion section](../work-items/work-item-form-controls.md#discussion) to add and review comments made about the work being performed to resolve the bug.
5663
::: moniker-end
5764

65+
5866
## Fields specific to bugs
5967

6068
The Bug work item type uses some bug-specific fields. Use the fields described in the following table to capture both the initial issue and ongoing discoveries. For information about fields specific to the CMMI process Bug, see [Bugs, issues, and risks field reference](../work-items/guidance/cmmi/guidance-bugs-issues-risks-field-reference-cmmi.md). For information about all other fields, see [Work item field index](../work-items/guidance/work-item-field.md).
6169

62-
6370
---
6471
:::row:::
6572
:::column span="1":::
Loading
Loading
Loading

docs/boards/backlogs/office/bulk-add-modify-work-items-excel.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -384,7 +384,7 @@ You can add a hierarchy of work items linked using parent-child links or other t
384384

385385
<a id="update-work-items "></a>
386386

387-
## Update pdate work items in bulk with a query list
387+
## Update work items in bulk with a query list
388388

389389
The easiest way to bulk update many work items is to create a query with the work items you want to update, and then open that query in Excel.
390390

docs/boards/includes/prerequisites-work-items.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.date: 09/07/2021
1414
* You must connect to a project. If you don't have a project yet, [create one](../get-started/sign-up-invite-teammates.md).
1515
* You must be added to a project as a member of the **Contributors** or **Project Administrators** security group. To get added, [Add users to a project or team](../../organizations/security/add-users-team-project.md).
1616
* To view or modify work items, you must 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 learn more, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md).
17-
* To add new tags to add to work items, you must have **Basic** access or higher and have the project-level **Create new tag definition** permissions set to **Allow**. By default, the **Contributors** group has this permission set. Even if the permission is explicitly set for a **Stakeholder**, they won't have permission to add new tags, as they are prohibited through their access level.
17+
* To add new tags to add to work items, you must have **Basic** access or higher and have the project-level **Create new tag definition** permissions set to **Allow**. By default, the **Contributors** group has this permission set. Even if the permission is explicitly set for a **Stakeholder**, they won't have permission to add new tags, as they are prohibited through their access level. To learn more, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md).
1818

1919

2020
::: moniker-end
@@ -24,6 +24,6 @@ ms.date: 09/07/2021
2424
* You must connect to a project. If you don't have a project yet, [create one](../../organizations/projects/create-project.md).
2525
* You must be added to a project as a member of the **Contributors** or **Project Administrators** security group. To get added, [Add users to a project or team](../../organizations/security/add-users-team-project.md).
2626
* To view or modify work items, you must 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 learn more, see [Set permissions and access for work tracking](../../organizations/security/set-permissions-access-work-tracking.md).
27-
* To add new tags to add to work items, you must have **Basic** access or higher and have the project-level **Create new tag definition** permissions set to **Allow**. By default, the **Contributors** group has this permission set. Even if the permission is explicitly set for a **Stakeholder**, they won't have permission to add new tags, as they are prohibited through their access level.
27+
* To add new tags to add to work items, you must have **Basic** access or higher and have the project-level **Create new tag definition** permissions set to **Allow**. By default, the **Contributors** group has this permission set. Even if the permission is explicitly set for a **Stakeholder**, they won't have permission to add new tags, as they are prohibited through their access level. To learn more, see [Stakeholder access quick reference](../../organizations/security/stakeholder-access.md).
2828

2929
::: moniker-end

0 commit comments

Comments
 (0)