feat: new Coverage and overview metrics

[claudiacodacy]

👀 Live preview

https://coverage-and-overview-metrics--docs-codacy.netlify.app/organizations/reporting/organization-overview/

🚧 To do

• If relevant, include the Jira issue key at the end of the pull request title
• Perform a self-review of the changes
• Fix any issues reported by the CI/CD

Test plan proposal

• Verify that all internal anchor links (e.g., #grade, #coverage, #overview-filters) resolve to the correct sections on the rendered page
• Confirm the Markdown tables in the 'Code health and security' and 'Coverage' sections render correctly without layout shifts or broken rows
• Validate that all newly referenced images (e.g., organization-overview-grade.png) exist in the repository and display correctly
• Check that external links to GitLab and Bitbucket documentation are functional and lead to the correct API references

[github-actions]

Overall readability score: 54.18 (🟢 +0.06)

File	Readability
organization-overview.md	62.32 (🟢 +13.89)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
organization-overview.md	62.32	38.92	8.71	11.8	12.87	6.4
	🟢 +13.89	🟢 +5.78	🟢 +3.05	🟢 +2.6	🟢 +0.3	🟢 +1.09

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	54.18	43.04	10.94	12.32	12.22	8.01
	🟢 +0.06	🟢 +0.02	🟢 +0.01	🟢 +0.01	🟢 +0	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[codacy-production]

Codacy's Analysis Summary

0 new issue (≤ 0 minor issue)
0 new security issue

Review Pull Request in Codacy →

✨ AI Reviewer available: add the codacy-review label to get contextual insights without leaving GitHub.

[codacy-production]

Pull Request Overview

The pull request is well-structured and follows the project's quality standards. No blocking security or logical issues were found. Suggestions are provided to enhance the clarity of the metric descriptions and maintain document consistency.

Test plan proposal

• Verify that the average grade calculation on the 'Grade' tab correctly processes exactly the 100 most recently updated repositories.
• Confirm that the 'Complexity' section highlighting logic correctly reflects the goals defined at the repository level.
• Validate that 'Coverage' for paid plans is calculated as a line-based aggregate (sum of covered / sum of coverable) rather than an average of individual repository percentages.
• Ensure the 'Duplication' distribution correctly categorizes repositories that have no configured quality goals.

About this PR

• The pull request title is missing a Jira issue key. Consider updating it to follow the format: feat: [JIRA-123] new Coverage and overview metrics.

---

🗒️ Improve review quality by adding custom instructions.
💡 Codacy uses AI. Check for mistakes.

[codacy-production]

_{🟡 MEDIUM RISK}

This sentence contradicts the definition provided a few lines above. If a file is 'below goal', it should not be categorized as 'complex' according to the criteria on line 98.

This might be a simple fix:

Suggested change

	At the bottom of the tab, the complex files distribution helps you understand which files are complex because they are above goal, below goal, or in repositories without a goal. Files are not filterable, while repository goal distributions are.
	At the bottom of the tab, the file distribution helps you understand which files are above goal, below goal, or in repositories without a goal. Files are not filterable, while repository goal distributions are.

[codacy-production]

_{⚪ LOW RISK}

Suggestion: The current phrasing is a bit informal. Improving the tone enhances the professional quality of the documentation.

Try running the following prompt in your IDE agent:

Rephrase the sentence to be more professional and technically precise: 'Because complexity is better when lower, repositories above goal are highlighted so you can review and act on them.'

[codacy-production]

_{⚪ LOW RISK}

Nitpick: Maintaining consistent spacing between headers and assets improves document readability and follows the pattern established in the previous sections.

This might be a simple fix:

Suggested change

	
	## Duplication