diff --git a/docs/organizations/reporting/images/organization-overview-coverage.png b/docs/organizations/reporting/images/organization-overview-coverage.png index ab6a4e118f..2c18ba9516 100644 Binary files a/docs/organizations/reporting/images/organization-overview-coverage.png and b/docs/organizations/reporting/images/organization-overview-coverage.png differ diff --git a/docs/organizations/reporting/organization-overview.md b/docs/organizations/reporting/organization-overview.md index fb393d76a4..524fe76ffc 100644 --- a/docs/organizations/reporting/organization-overview.md +++ b/docs/organizations/reporting/organization-overview.md @@ -128,10 +128,22 @@ For calculation details, see [how code coverage is calculated](../../faq/code-an ![Image of the Coverage tab](./images/organization-overview-coverage.png) -The Coverage tab on paid plans uses two key metrics: +The Coverage tab on paid plans is divided into two main sections: -- **Covered lines**: Number of covered lines reported to Codacy. -- **Coverable lines**: Number of lines that can be covered, based on coverage reports. +- **Line coverage** + + Uses three main metrics: + + - **Covered lines**: Number of covered lines reported to Codacy. + - **Coverable lines**: Number of lines that can be covered, based on coverage reports. + - **Coverage percentage**: The percentage of covered lines. + +- **File coverage** + + Uses two main metrics: + + - **Files with coverage**: Number of files that have coverage. + - **Total files**: Total number of files. These metrics drive all dashboard components: @@ -139,7 +151,11 @@ These metrics drive all dashboard components: | ------ | ----------- | | **Coverage** | `coveredLines / coverableLines`
Aggregation of all covered lines divided by all coverable lines across all repositories (or the current filter selection, see [filters](#overview-filters)). Includes only repositories reporting coverage. | | **Repositories reporting coverage** | Repositories with coverage data from the latest merged pull request. For example, if the latest merged pull request reported coverage metrics to Codacy, that repository is counted as reporting coverage. | -| **Coverage trend** | Time-based trend for covered lines, uncovered lines, and organization coverage (or the current filter selection, see [filters](#overview-filters)). You can choose time ranges and granularities, and select a date to see which repositories changed the most during that period. | +| **Coverage trend** | Time-based trend for covered lines, uncovered lines, and organization coverage (or the current filter selection, see [filters](#overview-filters)). You can choose time ranges and granularity, and select a date to see which repositories changed the most during that period. | +| **File coverage** | `filesWithCoverage / totalFiles`
Aggregation of all the files that have coverage divided by all the files across all repositories (or the current filter selection, see [filters](#overview-filters)). Includes only languages that support coverage. | +| **Files by coverage percentage** | Distribution chart grouping the files with coverage into coverage ranges: very low, low, medium, high, and very high. You can select one or more ranges to see the distribution of selected ranges for each language in the languages chart, each day in the trend chart, and the number of files within that range for each repository. | +| **File coverage by language** | Language breakdown showing file coverage percentages and covered/total file counts per language. You can choose one or more languages to view coverage performance across your repositories for those selected languages. | +| **File coverage trend** | Time-based trend for covered files, uncovered files, and overall file coverage percentage. You can choose time ranges and granularity, and select a date to see which repositories changed the most during that period. | You can export data from each chart using the ellipsis icon in the top-right corner in JSON or CSV format.