Skip to content

Commit 16f89cb

Browse files
authored
Merge pull request #8328 from MicrosoftDocs/users/chcomley/refreshes-ms.update-90-days
Refreshes for ms.update: 90-days ms.author: chcomley
2 parents 5718238 + 8e51505 commit 16f89cb

File tree

11 files changed

+446
-726
lines changed

11 files changed

+446
-726
lines changed

docs/boards/boards/kanban-quickstart.md

Lines changed: 42 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -5,37 +5,50 @@ description: Learn how to use your board to plan and track work in Azure Boards.
55
ms.custom: boards-kanban
66
ms.topic: quickstart
77
ms.service: azure-devops-boards
8+
ai-usage: ai-assisted
89
ms.author: chcomley
910
author: chcomley
1011
monikerRange: '<= azure-devops'
1112
ms.update: 90-days
12-
ms.date: 09/11/2024
13+
ms.date: 09/18/2025
1314
---
1415

1516
# Use your board
1617

1718
[!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)]
1819

19-
Boards provide an intuitive and visual way to manage your projects, track work items, and collaborate with your team effectively. If you have a project, you already have a board. Let's get started!
20+
Boards provide an intuitive, visual way to manage your projects, track work items, and collaborate with your team. If you have a project, you already have a board. This quickstart shows the most common board tasks so you can get productive fast.
21+
22+
What you'll learn:
23+
- How to add and update work items on your board.
24+
- How to map your team's workflow to columns and set WIP limits.
25+
- How to filter, invite teammates, and monitor basic analytics.
26+
27+
Quick steps:
28+
1. Open your team's board.
29+
2. Add work items (use the plus button).
30+
3. Move items across columns to update status.
31+
4. Set WIP limits and use filters to focus work.
2032

2133
> [!NOTE]
22-
> You can only create or add boards to a project by adding another team. Boards only get created when a project or team gets created. For more information, see [About teams and Agile tools](../../organizations/settings/about-teams-and-settings.md).
34+
> You can only create or add boards to a project by adding another team. Boards are created when a project or team is created. For more information, see [About teams and Agile tools](../../organizations/settings/about-teams-and-settings.md).
2335
2436
## Prerequisites
2537

2638
[!INCLUDE [temp](../includes/prerequisites-kanban.md)]
2739

2840
[!INCLUDE [enable-mcp-server](../includes/enable-mcp-server.md)]
2941

30-
[!INCLUDE [temp](../includes/open-kanban-board.md)]
42+
[!INCLUDE [temp](../includes/open-kanban-board.md)]
3143

3244
## Map the flow of how your team works
3345

34-
When you first open your board, there's one column for each [workflow state](../work-items/guidance/choose-process.md#workflow-states). Your actual columns vary based on the [process](../work-items/guidance/choose-process.md) used to create your project.
46+
When you first open your board, there's one column for each [workflow state](../work-items/guidance/choose-process.md). Your actual columns vary based on the [process](../work-items/guidance/choose-process.md) used to create your project.
3547

36-
1. Identify your team's workflow stages, which most likely don't map to the default states. For your team to have a functional board, configure the board to match your workflow stages.
48+
1. Identify your team's workflow stages—they often don't match the default states. Configure the board so it reflects the true handoffs your team uses.
3749

3850
For example, for user stories, the **New**, **Active**, **Resolved**, and **Closed** states track progress from idea to completion.
51+
3952
:::row:::
4053
:::column span="1":::
4154
![Screenshot showing user story workflow states.](media/alm-kb-workflow.png)
@@ -45,45 +58,43 @@ When you first open your board, there's one column for each [workflow state](../
4558
:::column-end:::
4659
:::row-end:::
4760

48-
2. [Manage your columns](add-columns.md), so they match your workflow stages. Keep the number of columns to a minimum while still representing the key handoffs that occur for your team.
61+
2. [Manage your columns](add-columns.md) so they match your workflow stages. Keep the number of columns minimal while still representing the key handoffs for your team.
4962

5063
:::image type="content" source="media/ALM_KB_Board2.png" alt-text="Screenshot showing board, Columns customized.":::
5164

5265
## Set WIP limits
5366

54-
Set work in progress (WIP) limits for each workflow stage, so that when work items exceed the limit, the column count displays as red. Teams can use this color as a signal to focus immediately on activities to bring the number of items in the column down. For more information, see [Set WIP limits](wip-limits.md).
67+
Set work in progress (WIP) limits for each workflow stage so that when items exceed the limit, the column count displays as red. Teams use that visual signal to immediately address bottlenecks. For more information, see [Set WIP limits](wip-limits.md).
5568

5669
:::image type="content" source="media/alm-kb-wip-limits.png" alt-text="Screenshot showing WIP limit reached with red numbering.":::
5770

5871
## Track work in progress
5972

60-
See the estimated size of work for each item that displays at the bottom right of each card. Add items to your backlog in the first column. When priorities change, move items up and down within a column. And, as work completes in one stage, update the status of an item by moving it to a downstream stage.
73+
See the estimated size of work for each item at the bottom right of each card. Add items to your backlog in the first column. When priorities change, move items up and down within a column. As work completes in one stage, update the status by moving the card to a downstream stage.
6174

6275
:::image type="content" source="media/alm-cc-move-card.png" alt-text="Screenshot showing moving a card on board to update status.":::
6376

64-
Update your board as work progresses to help keep your team in sync. Also, you can see and share the value stream your team is delivering to customers.
77+
Update your board frequently to keep the team in sync and to make the value stream visible.
6578

6679
[!INCLUDE [temp](../includes/note-kanban-boards-teams.md)]
6780

68-
## Add work items
81+
## Add work items
6982

70-
To add a work item, select the :::image type="icon" source="../media/icons/add_icon.png" border="false"::: plus sign, enter a title, and then select **Enter**.
83+
To add a work item, select the plus sign (the add icon), type a title, and press **Enter**. The system saves the work item automatically.
7184

7285
::: moniker range=">= azure-devops-2020"
7386
:::image type="content" source="media/quickstart/add-new-item-agile-s155.png" alt-text="Screenshot showing adding a new item on a board, new nav.":::
7487
::: moniker-end
7588

76-
The system automatically saves the work item with the title you entered. You can add as many work items you want by using this method.
77-
78-
To add details to any work item, select the title. Or, you can directly modify any field that displays. For example, you can reassign a work item by selecting **Assigned To**. For a description of each field, see [Create your backlog, Add details, and estimates](../backlogs/create-your-backlog.md#estimates). You can also [add tasks or child items as checklists on your cards](add-task-checklists.md).
89+
You can add as many work items as you want using this method. To add or edit details for any work item, select the title. You can also directly modify any field that appears on the card (for example, change **Assigned To**). For a description of each field, see [Create your backlog, Add details, and estimates](../backlogs/create-your-backlog.md#estimates). You can also [add tasks or child items as checklists on your cards](add-task-checklists.md).
7990

8091
[!INCLUDE [temp](../includes/note-user-assigned.md)]
8192

8293
<a id="update-status"> </a>
8394

8495
## Update work item status
8596

86-
As work completes in one stage, update the status of an item by dragging it to a downstream stage.
97+
As work progresses, update the status of an item by dragging it to a downstream column.
8798

8899
[!INCLUDE [note-closed-items](../includes/note-closed-items.md)]
89100

@@ -92,26 +103,27 @@ As work completes in one stage, update the status of an item by dragging it to a
92103
> Users assigned Stakeholder access can't use the drag-and-drop feature to update status.
93104
::: moniker-end
94105

95-
:::image type="content" source="media/alm-cc-move-card.png" alt-text="Screenshot showing update status of work item with arrow showing movement of card.":::
106+
:::image type="content" source="media/alm-cc-move-card.png" alt-text="Screenshot showing update status of work item with arrow showing movement of card.":::
96107

97108
## Update card fields
98109

99-
You can quickly update a field or reassign ownership directly from the board. If the field you want to update isn't showing, then customize the card, so it displays. You can also show other work item types besides bug and user stories, like change requests, incidents, issues, or other custom work item types. For more information, see [Customize cards](../../boards/boards/customize-cards.md) and [About configuring and customizing Azure Boards](../configure-customize.md).
110+
Quickly update a field or reassign ownership directly from the board. If the field you want to update isn't showing, customize the card to display it. You can also show other work item types, such as change requests, incidents, issues, or custom types. For more information, see [Customize cards](../../boards/boards/customize-cards.md) and [About configuring and customizing Azure Boards](../configure-customize.md).
100111

101112
:::image type="content" source="media/alm-cc-update-card-field.png" alt-text="Screenshot showing update of card field.":::
102113

103114
### Filter your board with keywords, field values, or tags
104115

105-
You can apply filters interactively to focus on a subset of work. For example, you can filter the board to focus on work assigned to at team member for a specific sprint. To start filtering, choose **Filter** :::image type="icon" source="../../media/icons/filter-icon.png" border="false":::. For more information, see [Filter your backlogs, boards, and plans](../backlogs/filter-backlogs-boards-plans.md).
116+
Apply interactive filters to focus on a subset of work. For example, filter the board to show work assigned to a specific team member during a sprint. To start filtering, choose **Filter** :::image type="icon" source="../../media/icons/filter-icon.png" border="false":::. For more information, see [Filter your backlogs, boards, and plans](../backlogs/filter-backlogs-boards-plans.md).
117+
118+
In the following example image, we filtered items assigned to Jamal and Raisa.
106119

107-
In the following example image, we filtered all items assigned to Jamal and Raisa.
108120
::: moniker range=">= azure-devops-2020"
109121
:::image type="content" source="../backlogs/media/filter-boards/filter-kb-filters-chosen-services.png" alt-text="Screenshot showing filtering on assignment field.":::
110122
::: moniker-end
111123

112-
## Invite others to work on your board
124+
## Invite others to work on your board
113125

114-
All members of a project can view and contribute to your board. To invite users to contribute, copy the URL of your board and send it to those users.
126+
All members of a project can view and contribute to your board. To invite users to contribute, copy the URL of your board and send it to them.
115127

116128
::: moniker range=">= azure-devops-2020"
117129
:::image type="content" source="media/quickstart/kanban-board-url-s155.png" alt-text="Screenshot showing red square surrounding the URL for the board.":::
@@ -121,36 +133,35 @@ To add users to your project, see [Add users to a project](../../organizations/s
121133

122134
## Monitor metrics
123135

124-
As with most Agile practices, you're encouraged to monitor key metrics to fine tune your processes. After your team uses the board for several weeks, check out your Cumulative Flow Diagram (CFD).
136+
After your team uses the board for several weeks, review key metrics like the Cumulative Flow Diagram (CFD) to optimize your process.
125137

126138
::: moniker range=">= azure-devops-2020"
127139
Choose the **Analytics** tab, and then choose **View full report** for the CFD as shown in the following image.
128140

129141
:::image type="content" source="media/quickstart/open-analytics.png" alt-text="Screenshot showing highlighted Analytics tab.":::
130142

131-
Use the interactive controls to choose the time frame, swimlanes, and workflow states or board columns.
132-
133-
Hover over a point in time to show how many work items are in a particular state.
143+
Use the interactive controls to choose the time frame, swimlanes, and workflow states or board columns. Hover over a point on the CFD to see how many items were in a particular state at that time.
134144

135-
The following example image shows that on July 3, 101 items were in a *Researching* state.
145+
The following example shows that on July 3, 101 items were in a *Researching* state.
136146

137147
:::image type="content" source="../../report/dashboards/media/cfd/analytics-cfd-azure-devops.png" alt-text="Screenshot showing opened CFD Analytics.":::
138148

139149
> [!TIP]
140-
> The selections you make only get set for you, and persist across sessions until you change them.
150+
> Your selections persist across sessions until you change them.
151+
141152
::: moniker-end
142153

143-
By monitoring these metrics, you can gain insight into how to optimize your processes and minimize lead time. For more information, see [Configure a cumulative flow chart](../../report/dashboards/cumulative-flow.md).
154+
By monitoring these metrics, you can find opportunities to reduce lead time. For more information, see [Configure a cumulative flow chart](../../report/dashboards/cumulative-flow.md).
144155

145-
You can also add Analytics widgets to your dashboard. The Analytics Service is in preview and provides access to several widgets. For more information, see the following articles:
156+
You can also add Analytics widgets to your dashboard. The Analytics Service is in preview and provides access to several widgets. For more information, see:
146157
- [Widgets based on the Analytics Service](../../report/dashboards/analytics-widgets.md)
147158
- [Add a widget to a dashboard](../../report/dashboards/add-widget-to-dashboard.md)
148159
- [What is the Analytics Service?](../../report/powerbi/what-is-analytics.md)
149160

150161
## Can I view a board of work items defined by a query?
151162
The [Query Based Boards](https://marketplace.visualstudio.com/items?itemName=realdolmen.EdTro-AzureDevOps-Extensions-QueryBasedBoards-Public) Marketplace extension supports viewing a flat-list query of work items as a board. The query can contain different work item types and work items defined in different projects.
152163

153-
## Next steps
164+
## Next step
154165

155166
> [!div class="nextstepaction"]
156167
> [Expedite work using swimlanes](expedite-work.md)

0 commit comments

Comments
 (0)