Manage issues or impediments

VSTS | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

If you have known issues you want to track, you can do so by defining an impediment (Scrum) or issue (Agile or CMMI). Impediments and issues represent unplanned activities. Resolving them requires more work beyond what's tracked for actual requirements. Using the impediment work item type helps you track and manage these issues until you can resolve and close them.

Don't confuse impediments with bugs. You track impediments that may cause problems with delivering one or more requirements. For example, you may have to address feature ambiguity, personnel or resource issues, problems with environments, or other risks that impact scope, quality, or schedule. Other issues that deserve tracking are decisions that require several stakeholders or product teams to weigh in on.

In this topic you'll learn:

  • How to capture issues or impediments as a work item

Prerequisites

  • You must be a member of the Contributors group or be granted Stakeholder access to add, modify, or remove work items
  • Or, you must have your View work items in this node, and your Edit work items in this node permissions set to Allow.

To learn more, see Set permissions and access for work tracking.

Add an issue or impediment

Note

The images you see from your web portal may differ from the images you see in this topic. These differences result from updates made to your web app, options that you or your admin have enabled, and which process was chosen when creating your team project—Agile, Scrum, or CMMI.

From the Work hub, choose Impediment from the New Work Item list of options. Click the pin icon pin icon to have it show up within the Work hub drop down menu.

VSTS, TFS 2017 - Add an impediment

From the Queries page, choose Impediment from the New drop down menu.

TFS 2015, TFS 2013 - Add an impediment

Customize issues tracking

You can add fields, change the workflow, add custom rules, and add custom pages to the work item form of most work item types. You can also add custom work item types. For details, see Customize an inheritance process.

You can add fields, change the workflow, add custom rules, and add custom pages to the work item form of most work item types. You can also add custom work item types. For details, see Customize the On-premises XML process model.

Impediments and issues don't appear on your backlog. Instead, you track them using queries. If you want them to appear on your backlog, or you want to track other work item types on your backlog, see Customize your backlogs or boards.

Impediments and issues don't appear on your backlog. Instead, you track them using queries. If you want them to appear on your backlog, or you want to track other work item types on your backlog, see Add a work item type to a backlog and board.