Secret ingredients to quality software

SSW Foursquare

Do you know when you use @ mentions in a PBI?

Last updated by Tylah Kapa [SSW] on 05 Jan 2022 12:13 am (5 months ago) See History

When the Product Owner verbally requests a change to a PBI, how do you update the PBI to reflect the change and also keep track of the conversation?

You could send yourself a "To Myself" email and update the PBI description accordingly, but only those people included in the email chain are aware of the conversation. Only send a "To Myself" email when there is no product backlog that is related to the request, otherwise you should create or update a PBI and @ mention the Product Owner and other relevant people (@ mentioned people will still receive an email).

bad mention pbi
Figure: Bad Example – don't use emails to update tasks

Instead, what you should do is use the discussions feature in the PBI and mention the user using "@<username>". The benefits of using comments are:

  • Quick and easy, no need to compose an email
  • History is visible to anyone looking at the PBI (with email, if you don’t cc them, they wouldn’t have a clue)
  • Easy to see all important notes/comments in one place instead of digging through email

When someone (especially the PO) asks you to fix a PBI, mention that person in the PBI comments so he knows when it’s fixed.

Example: When replying to "Hey XXX, can you please fix PBI 123?"

Bad example: "I have found the PBI and moved it near the top of our backlog"

Good example: "I have found the PBI, prioritized it near the top, and @mentioned you so you know when it is fixed"

Azure DevOps PBIs

To create a new PBI in your Azure DevOps project:

  1. Navigate to Boards | + New Work Item and select the type that best suits your item
  2. Enter your PBI title
  3. @ mention your desired user in the description

good mention pbi
Figure: Good Example – Using @ mentions in Azure DevOps discussion

good mention pbi 2
Figure: Good Example – Email still gets sent to the users who are mentioned in the discussion, so they can still chime in if any details are incorrect

GitHub Issues

MicrosoftTeams image
Figure: Good Example – Using @ mentions in GitHub

Tip: You can @mention on your pull requests as well.

Eric PhanEric Phan
Adam CoganAdam Cogan

We open source. Powered by GitHub