The Review Analysis page in SourceTraq offers a comprehensive examination of pull request (PR) activities, enabling teams to assess reviewer performance, contributions over time, and the overall status of PRs. This insightful feature is designed to enhance understanding of team interactions and improve overall workflow efficiency.
Key Metrics Overview
The Review Analysis page is built around several key metrics presented through interactive charts:
1. Top Reviewers Chart
This chart visualizes the performance of individual reviewers based on their activities in the PR process. It includes the following metrics:
- Days Analyzed: Displays the total analysis duration, such as "6 Days," which gives context to the metrics shown.
- Reviewers Count: Shows the total number of different reviewers who have contributed, for instance, "312," highlighting team participation.
- Contributors Count: Represents the number of unique contributors involved, such as "409," reflecting engagement levels.
The data visualization is structured as follows:
- X-axis: Displays the names or identifiers of reviewers (e.g., Reviewer A, Reviewer B).
- Y-axis: Represents PR counts and various metrics, allowing quick comparisons.
- Green Bars: Indicate the number of PRs approved by each reviewer.
- Yellow Bars: Show PRs that are still pending review.
- Orange Line: Illustrates the average age of PRs (in days) that are open, providing insights into how long PRs have been awaiting review.
- Blue Line: Depicts the cycle time—this is the time taken from the creation of a PR to its approval or decline, helping to assess responsiveness.
2. Pull Requests Chart
This chart summarizes the total PR activities categorized by author groups. It includes:
- Created PRs: Displays the total number of PRs created, offering insight into contributions.
- Merged PRs: Shows the total number of PRs that were successfully merged.
- Declined PRs: Represents the total count of PRs that were rejected, allowing teams to spot trends in rejection.
The data visualization format is similar to the Top Reviewers Chart:
- X-axis: Features author identifiers (e.g., Author 1, Author 2).
- Y-axis: Demonstrates PR counts and metrics in a comparable format to the Top Reviewers Chart.
Detailed Author Metrics
The Author Wise Metrics Table allows users to evaluate individual contributions more thoroughly. This table contains important columns, including:
- Author Name: Name of each contributor.
- Email: Corresponding email for the author.
- Total Commits: Number of commits made by the author during the selected reporting period.
- PRs: Total PRs submitted by the author.
- Merged: Successful merges of their PRs.
- Declined: Number of PRs that were not accepted.
- Age: Average number of days PRs were open.
- Lag: Average days between first commit and PR creation.
- Merge: Average days taken to merge PRs.
Interactive Insights
Users can click on any row in the Author Wise Metrics Table to reveal a detailed popover window with specific metrics for each PR submitted by that author. This feature facilitates focused analysis of PR performance, enhancing collaboration and enabling informed decision-making.
Benefits of Review Analysis
By utilizing the Review Analysis page, teams can:
- Evaluate individual contributions to better understand team dynamics.
- Identify bottlenecks in the PR review process and improve responsiveness.
- Encourage collaboration by monitoring reviewer activities and contributions.
- Make data-driven decisions that improve overall project outcomes.