Skip to content

Commit 894dede

Browse files
committed
add more info on merged prs section
1 parent 322e562 commit 894dede

1 file changed

Lines changed: 24 additions & 5 deletions

File tree

docs/organizations/codacy-usage.md

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,31 @@ This chart shows the trend of repositories in your organization over time, consi
3636

3737
## Merged pull requests
3838

39-
This chart displays the number of pull requests merged in your repositories, categorizing them as either analyzed or not analyzed.
40-
Analyzed PRs are further broken down into three sub-categories:
39+
This chart tracks the total volume of pull requests merged across your Codacy-managed repositories. It serves as a high-level health check to ensure that your team's development velocity is aligned with your quality standards.
4140

42-
- Passing Gates: Merged PRs that successfully passed all quality gates.
43-
- Failing Gates: Merged PRs that failed one or more quality gates.
44-
- Without Gates: Merged PRs where no quality gates were configured or applied.
41+
### Understanding the categories
42+
43+
- Passing Gates: These PRs met all your quality standards (e.g., coverage, complexity, security) before being merged.
44+
- Failing Gates: PRs merged despite failing one or more quality checks.
45+
- Without Gates: PRs merged into repositories where no quality gates are configured.
46+
- Never Analyzed: PRs that reached a "Merged" status without Codacy completing an analysis.
47+
48+
### Why are some PRs "Never analyzed"?
49+
50+
If you see high numbers here, it usually boils down to two scenarios:
51+
52+
1. A developer merged the PR immediately after opening it, before the Codacy analysis could finish.
53+
2. In self-service organizations, if a PR is authored by an email/user not yet added to your Codacy seat count, the analysis may be skipped.
54+
55+
If you notice a high volume of PRs in Without gates, or Never analyzed categories, consider the following actions:
56+
57+
### Without gates:
58+
59+
To ensure your code meets organizational standards, you should define a Quality Gate rule for the repository, such as setting thresholds for "New issues > 0" or "Coverage < 80%."
60+
61+
### Never analyzed:
62+
63+
To ensure your team adjusts their workflow to wait for the "Codacy/Analysis" check to turn green before merging. Additionally, you should check your [seat management](../organizations/managing-people.md) to confirm that all active contributors are correctly mapped to a Codacy seat.
4564

4665
Interacting with the chart allows you to filter the data, with the resulting repositories displayed in the "Top repositories" list.
4766

0 commit comments

Comments
 (0)