Plan and track work in Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

In this article, learn how to use Azure Boards to plan and track your work using an Agile, Basic, Scrum, or Capability Maturity Model Integration (CMMI) process. For more information, see About processes and process templates.

Note

The Basic process is available when you add a project to Azure DevOps Services or Azure DevOps Server 2019 Update 1. For earlier on-premises deployments, choose Agile, Scrum, or CMMI process.

The Agile process uses various work item types such as user stories, tasks, bugs, features, and epics to plan and track work. Begin by adding user stories and grouping them into features if needed. You can add tasks to a user story to track more details.

Work item types Backlog hierarchy
Agile process work item types, conceptual image. Screenshot of Agile process Hierarchical backlog.

Within each work item form, you can describe the work to be done, assign work to project contributors, track status, and collaborate with others through the Discussion section.

We show you how to add user stories and child tasks from the web portal and add details to those work items.

Prerequisites

  • You must have Basic access and be a member of the Contributors or Project Administrators group to add work items to a board and use all other board features.
  • You must have Stakeholder access for a private project and be a member of the Contributors or Project Administrators group to view boards, open and modify work items, and add child tasks to a checklist. But, you can't reorder or reparent a backlog item using drag-and-drop, nor update a field on a card.
  • You must have Stakeholder access for a public project and be a member of the Contributors or Project Administrators group to have full access to all Boards features.
  • You must have Basic access and be a member of the Contributors or Project Administrators group to add work items to a board and use all other board features.
  • You must have Stakeholder access and be a member of the Contributors or Project Administrators group to view boards, open and modify work items, and add child tasks to a checklist. But, you can't reorder or reparent a backlog item using drag-and-drop, nor update a field on a card.

Note

To drag-and-drop cards to different, columns you must have Azure DevOps Server 2020 Update 1.

  • You must have Basic access and be a member of the Contributors or Project Administrators group to add work items to a board and use all other board features.
  • You must have Stakeholder access for a private project and be a member of the Contributors or Project Administrators group to view boards, open and modify work items, and add child tasks to a checklist. But, you can't reorder or reparent a backlog item using drag-and-drop, nor update a field on a card.
  • You must have Stakeholder access for a public project and be a member of the Contributors or Project Administrators group to have full access to all Boards features.

For more information, see Default permissions and access for Azure Boards.

Open your Kanban board

A Kanban board is provisioned with the addition of each project and each team. You can only create or add Kanban boards to a project by adding another team. For more information, see About teams and Agile tools.

  1. Sign in to your organization (https://dev.azure.com/{your_organization}) and go to your project.

  2. Select Boards > Boards.

    Screenshot showing two selections highlighted with red boxes, to open boards.

  3. Select a board from the All Team Boards dropdown menu.

    Screenshot showing All Team Boards to choose from, listed in the dropdown menu.

Add work items to your board

Work items on your board are automatically assigned the default Area Path and Iteration Path assigned to the team. For more information, see Configure team settings.

  1. From the Stories board, choose New item and the stories you want to track.

    Add new item, Kanban board, Agile process.

  2. Enter return and the system assigns a work item ID to the user story.

    Added item, Agile process.

  3. Add as many user stories as you need.

Tip

To quickly add features and child user stories, choose Features from the board selector. Screenshot to Open the features board, Agile process.

Add details to a board item

Select the issue or user story title to open it. Change one or more field values, add a description, or make a note in the Discussion section. You can also choose the attachments icon Attachments tab and drag-and-drop a file to share the file with others.

For example, here we assign the story to Raisa Pokrovskaya and add a discussion note, at-mentioning Raisa.

Screenshot of User Story work item form.

Choose Save & Close when you're done.

Field descriptions


Field

Usage


Enter a description of 255 characters or less. You can always modify the title later.


Assign the work item to the team member responsible for performing the work. Depending on the context you're working in, the drop-down menu lists only team members or contributors to the project.

Note

You can only assign work to a single user. If you need to assign work to more than one user, add a work item for each user and distinguish the work to be done by title and description. The Assigned To field only accepts user accounts that have been added to a project or team.


When the work item is created, the State defaults to the first state in the workflow. As work progresses, update it to reflect the current status.


Use the default first. Update it when you change state as need. Each State is associated with a default reason.


Choose the area path associated with the product or team, or leave blank until assigned during a planning meeting. To change the dropdown list of areas, see Define area paths and assign to a team.


Choose the sprint or iteration in which the work is to be completed, or leave it blank and assign it later during a planning meeting. To change the drop-down list of iterations, see Define iteration paths and configure team iterations.


Provide enough detail to create shared understanding of scope and support estimation efforts. Focus on the user, what they want to accomplish, and why. Don't describe how to develop the product. Do provide sufficient details so that your team can write tasks and test cases to implement the item.


Provide the criteria to be met before the work item can be closed. Define what "Done" means by describing the criteria for the team to use to verify whether the backlog item or bug fix is fully implemented. Before work begins, describe the criteria for customer acceptance as clearly as possible. Have conversations between the team and customers to determine the acceptance criteria. These criteria help ensure a common understanding within the team to meet customers' expectations. Also, this information provides the basis for acceptance testing.


A subjective rating of the issue or task it relates to the business. You can specify the following values:

  • 1: Product cannot ship without the successful resolution of the work item, and it should be addressed as soon as possible.
  • 2: Product cannot ship without the successful resolution of the work item, but it does not need to be addressed immediately.
  • 3: Resolution of the work item is optional based on resources, time, and risk.
  • 4: Resolution of the work item is not required.

A subjective rating of the issue or task it relates to the business. You can specify the following values:

  • Architectural: Technical services to implement business features that deliver solution .
  • Business: Services that fulfill customers or stakeholder needs that directly deliver customer value to support the business (Default).

Provide a relative estimate of the amount of work required to complete an issue. Most Agile methods recommend that you set estimates for backlog items based on relative size of work. Such methods include powers of 2 (1, 2, 4, 8) and the Fibonacci sequence (1, 2, 3, 5, 8, etc.). Use any numeric unit of measurement your team prefers.
The estimates you set are used to calculate team velocity and forecast sprints.


Update work status

The State field tracks the status of a work item. With the Kanban board, you can quickly update the status of backlog items by dragging and dropping them to a different column.

As work begins, drag the user story card from the Backlog column to the Active column. Once work is ready for review, move it to the Resolved column. After it's reviewed and accepted, move it to the Closed column.

Screenshot showing updating status on Kanban board, Agile process.

Tip

To add or rename columns as needed, see Customize your board.

Add tasks

Task checklists provide a quick and easy way to track elements of work that are important to support completing a backlog item. Also, you can assign individual tasks to different team members.

Tip

Tasks that you create from the Kanban board are automatically assigned the Area Path and Iteration Path of their parent work item and show up on your sprint taskboard.

Tasks that you create from the sprint backlog or taskboard show up within tasks checklists on the Kanban board.

  1. Select the actions icon for the story and select plus icon Add Task.

    Choose Add Task from the User Story card menu, Agile process.

    Enter a title for the task and select Enter when you're done.

    Add first task, Agile process.

  2. If you have many tasks to add, keep entering your task titles and type Enter.

    Several tasks added, Agile process.

  3. You can mark a task as done, expand or collapse the task checklist, or reorder and reparent tasks.

    Mark a task as done Reorder and reparent tasks Expand or collapse the checklist
    To mark a task as complete, check the task checkbox. The task State changes to Done.
    Mark task as done
    To reorder a task, drag it within the checklist. To reparent a the task, drag it to another issue on the board.
    Drag tasks to reorder them within the list
    To expand or collapse a task checklist, simply choose the task annotation.
    Collapse task checklist

Add details to a task

If you have details you want to add about a task, choose the title, to open it. Change one or more field values, add a description, or make a note in the Discussion section. Choose Save & Close when you're done.

Here we assign the task to Christie Church.

Screenshot of Task work item form, Agile process.

Field descriptions

In addition to the fields you can define for a backlog item—user story, issue, product backlog item, or requirement—you can specify the following fields for a task to support capacity and time tracking.

Note

There are no inherent time units associated with this field even though the taskboard always shows "h" for hours in relationship to Remaining Work. You can specify work in any unit of measurement your team chooses.

Field

Usage


The type of activity that's required to do a task.For more information about how this field is used, see Capacity planning. Allowed values are:

  • Deployment
  • Design
  • Development
  • Documentation
  • Requirements
  • Testing

Discipline (CMMI process)

The type of activity that's required to do a task.For more information about how this field is used, see Capacity planning. Allowed values are:

  • Analysis
  • Development
  • Test
  • User Education
  • User Experience

The amount of estimated work required to complete a task. Typically, this field doesn't change after it's assigned.

The amount of work that remains to finish a task. You can specify work in hours or in days. As work progresses, update this field. It's used to calculate capacity charts and the sprint burndown chart.
If you divide a task into subtasks, specify Remaining Work for the subtasks only.

The amount of work spent implementing a task. Enter a value for this field when you complete the task.

Task Type (CMMI only)

Select the kind of task to implement from the allowed values:

  • Corrective Action
  • Mitigation Action
  • Planned

Capture comments in the Discussion section

Use the Discussion section to add and review comments made about the work being performed.

Screenshot showing the Discussion section within a work item form.

The rich text editor tool bar displays below the text entry area. It appears when you select each text box that supports text formatting.

Screenshot of Discussion section, Rich Text Editor toolbar.

Note

There isn't a Discussion work item field. To query work items with comments entered in the Discussion area, you filter on the History field. The full content of the text entered into the Discussion text box is added to the History field.

Mention someone, a group, work item, or pull request

To open a menu of recent entries you've made to mention someone, link to a work item, or link to a pull request, select or , or enter @, #, or !.

Screenshot of Discussion section, at-mention drop-down menu.

Enter a name or number and the menu list filters to match your entry. Choose the entry you want to add. To bring a group into the discussion, enter @ and the group name, such as a team or security group.

Edit or delete a comment

To edit or delete any of your discussion comments, choose Edit or choose the actions icon, and then choose Delete.

Screenshot of Discussion section, Edit, Delete actions.

Note

Editing and deleting comments requires Azure DevOps Server 2019 Update 1 or later version.

After updating the comment, choose Update. To delete the comment, confirm that you want to delete it.

A full audit trail of all edited and deleted comments is maintained in the History tab on the work item form.

Important

For on-premises Azure DevOps Server, you must configure an SMTP server for team members to receive notifications.

Add a reaction to a comment

Add one or more reactions to a comment by choosing a smiley icon at the upper-right corner of any comment. Or, choose from the icons at the bottom of a comment next to any existing reactions. To remove your reaction, choose the reaction on the bottom of your comment. The following image shows an example of the experience of adding a reaction and the display of reactions on a comment.

Screenshot of Discussion control, Add reactions to a comment.

Save a comment without saving the work item

Note

This feature is available starting in Azure DevOps Server 2022.1.

If you only have permissions to add to the Discussion of a work item, then you can do so by saving comments. This permission is controlled by Area Path nodes and the Edit work item comments in this node permission. For more information, see Set work tracking permissions, Create child nodes, modify work items under an area or iteration path.

Once you save the comments, you don't need to save the work item.

Screenshot of Discussion section, save comment.

Note

When you save changes made to the Discussion control, only the comment is saved. No work item rules defined for the work item type execute.

Next steps