diff --git a/docs/organizations/codacy-usage.md b/docs/organizations/codacy-usage.md new file mode 100644 index 0000000000..c6d09a9cb3 --- /dev/null +++ b/docs/organizations/codacy-usage.md @@ -0,0 +1,57 @@ +# Codacy usage + +The **Codacy usage** dashboard offers an overview of your organization's adoption of Codacy. You can filter the displayed list of repositories by their Git provider, as well as by their gate and coverage information within Codacy. Additionally, you can filter by selecting specific repositories or by using [the segments that you have set up](segments.md). + +![Codacy usage dashboard](images/codacy-usage-dashboard.png) + +!!! important + Repositories not in Codacy is only available to GitHub accounts. + +To view the **Codacy usage** dashboard: + +- Select an organization from the top navigation bar. +- On the organization overview page, click the Codacy usage tab. + +The Codacy usage dashboard includes the following sections to help you monitor Codacy adoption: + +- [Repositories](#repositories) +- [Repositories evolution](#repositories-evolution) +- [Merged pull requests](#merged-pull-requests) +- [Top repositories](#top-repositories) + +!!! tip + In each section, you can click on the ellipsis icon in the top right corner to export that section's data to CSV or JSON. + +## Repositories + +This chart displays the distribution of repositories in Codacy and repositories that aren't. The doughnut chart also details the breakdown of Codacy repositories based on their configuration: those without quality gates, without coverage, without either gates or coverage, and those with both gates and coverage. Users can interact with the doughnut chart or the numerical data to filter the results. Applying a filter will also affect the repositories displayed in the evolution chart and the results will appear in the "Top repositories" list. + +![Repositories distribution](images/repositories-distribution.png) + +## Repositories evolution + +This chart shows the trend of repositories in your organization over time, considering the filters applied. You can hover over the chart to see the number of repositories on a specific date. You can also click on the chart to filter results. + +![Repositories evolution](images/repositories-evolution.png) + +## Merged pull requests + +This chart displays the number of pull requests merged in your repositories, categorizing them as either analyzed or not analyzed. +Analyzed PRs are further broken down into three sub-categories: + +- Passing Gates: Merged PRs that successfully passed all quality gates. +- Failing Gates: Merged PRs that failed one or more quality gates. +- Without Gates: Merged PRs where no quality gates were configured or applied. + +Interacting with the chart allows you to filter the data, with the resulting repositories displayed in the "Top repositories" list. + +!!! note + Merged pull requests data is only from repositories that are in Codacy. + +![Merged pull requests](images/merged-pull-requests.png) + +## Top repositories + +The list shows a maximum of 10 repositories from your Git provider. You can use filters to display repositories that aren't yet in Codacy, or repositories that are already in Codacy. For repositories in Codacy, the list can also group them by specific metrics such as gates, coverage, and merged pull request information. + +![Top repositories](images/top-repositories.png) diff --git a/docs/organizations/images/codacy-usage-dashboard.png b/docs/organizations/images/codacy-usage-dashboard.png new file mode 100644 index 0000000000..bff4aaa6a3 Binary files /dev/null and b/docs/organizations/images/codacy-usage-dashboard.png differ diff --git a/docs/organizations/images/merged-pull-requests.png b/docs/organizations/images/merged-pull-requests.png new file mode 100644 index 0000000000..fcc70c0a79 Binary files /dev/null and b/docs/organizations/images/merged-pull-requests.png differ diff --git a/docs/organizations/images/repositories-distribution.png b/docs/organizations/images/repositories-distribution.png new file mode 100644 index 0000000000..10e25a2a06 Binary files /dev/null and b/docs/organizations/images/repositories-distribution.png differ diff --git a/docs/organizations/images/repositories-evolution.png b/docs/organizations/images/repositories-evolution.png new file mode 100644 index 0000000000..174e134208 Binary files /dev/null and b/docs/organizations/images/repositories-evolution.png differ diff --git a/docs/organizations/images/top-repositories.png b/docs/organizations/images/top-repositories.png new file mode 100644 index 0000000000..0a76b7f3f2 Binary files /dev/null and b/docs/organizations/images/top-repositories.png differ diff --git a/mkdocs.yml b/mkdocs.yml index de75539891..ccaafd951c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -611,6 +611,7 @@ nav: - organizations/managing-repositories.md - organizations/segments.md - organizations/issues-metrics.md + - organizations/codacy-usage.md - organizations/ai-risk-hub.md - organizations/using-gate-policies.md - organizations/using-coding-standards.md