PR resolution reviews merged PRs for key health indicators to support healthy work patterns.
Use PR resolution to filter for outliers in a team's work patterns. Use the distribution charts to identify the root cause of outliers in productivity. Additionally, view trends for time to merge and first comment for PRs.
In this article
How to use PR resolution
With PR resolution, team leads, managers, and executives can:
- Understand a team's PR activity trends and use these patterns to support work trends.
- Identify normal patterns and outliers in the code review process.
- Track progress against collaboration targets.
- Review merged PRs to spot teams’ trends.
To find the PR resolution report:
- In the top navigation, click Reports.
- In the left navigation under Team processes, click PR resolution.
Time to merge
Pull requests: time to merge shows all pull requests merged during a selected period.
Use Time to merge to:
- View patterns in your team's PR resolution practices.
- Manage your team’s productivity trends.
- Compare your team’s productivity against targets.
The x-axis shows when a PR was merged. The y-axis shows how long it took to merge the PR.
Note: If the Weighted toggle is On, the y-axis on the Time to merge graph shows Time to merge divided by Impact. For each merged PR, Time to merge is divided by the Impact for the PR. If the Weighted toggle is Off, the y-axis shows only Time to merge. Use this toggle to see spikes in Time to merge once you account for the complexity that Impact represents.
Use the Time to merge graph to filter for outliers. This helps you see if your team is meeting their targets.
For example, if your team’s Time to merge is higher than your target, you want to see those trends going down. Review this chart weekly or biweekly to ensure those trends are improving.
If your Time to merge is close to your target, use this report to look into other times where Time to merge is high. This helps you identify issues that cause outliers.
Merge metrics
This section shows key metrics on PRs merged during a selected period. These graphs help you identify outliers and manage the root causes of productivity variation.
Note: Only merged PRs count toward the metrics calculations in this report.
Use these graphs to gauge how your team is performing. You’ll see the median values for PR metrics. You'll also see maximums, minimums, and targets where applicable. If you’d rather see the average Time to merge and Time to first comment metrics, use Team health insights.
Click a column to view the details of those PR metrics in the PR list below. For example, if your maximum is 75 hours, you might want to look into the PRs that took longer and see where your team can improve.
To view PR details, click the column you want more information about. View the specific PRs and participant details in the PR timeline at the bottom of the page. Hover over any listed PR for an overview of that PR.
Note: Flow determines PR size by the PR’s total lines of code. Small PRs have fewer than 13 lines of code. Medium PRs have fewer than 151 lines of code. Large PRs have more than 151 lines of code.
To keep the PR overview open on the page, click the PR and select Pin PR details from the resulting dropdown menu. To open the PR in a new tab, click the PR and select Open PR from the resulting dropdown menu.
Click the Participants tab to see a list of reviewers who contributed to PRs, with an overview of their contributions. For each reviewer, see the number of comments they have made, how many PRs they were the submitter for, what their Time to first comment is, and how many follow-on commits they have made. Time to first comment is represented as N(days:hours:minutes) where N is the number of times the reviewer has made the first comment on a PR, and the time is the average time it took the reviewer to make the first comment.