Do you link commits, branches, and PRs to a PBI?

Last updated by Brady Stroud [SSW] about 1 year ago.See history

To improve visibility into what work has been done, link your PBIs and tasks to the related commits, branches, and pull requests. Every commit, branch, and PR should be associated with a PBI.

no linked commit
Figure: Bad example - No linked commits, branches or pull requests

link branch to pbi
Figure: Good example - Git branch linked to PBI in Azure DevOps

Using Azure DevOps

If you create branches through Azure DevOps, you can link them to a work item during the creation process.

link pbi during creation
Figure: Good example - Using Azure DevOps to link PBI during creation

Learn more on this article: Linking Work Items to Git Branches, Commits, and Pull Requests.

Automating rule enforcement

You can setup Branch Policies on your main branches to enforce this behaviour.

add branch policy for linked items
Figure: Good example - Branch Policy on the master branch to enforce linked work items on pull requests


Adam Cogan
Andreas Lengkeek
Barry Sanders
Jernej Kavka
Patricia Barros
We open source.Loving SSW Rules? Star us on GitHub. Star
Stand by... we're migrating this site to TinaCMS