You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/organizations/codacy-usage.md
+24-5Lines changed: 24 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,12 +36,31 @@ This chart shows the trend of repositories in your organization over time, consi
36
36
37
37
## Merged pull requests
38
38
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.
41
40
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.
45
64
46
65
Interacting with the chart allows you to filter the data, with the resulting repositories displayed in the "Top repositories" list.
0 commit comments