update docs with directories info OD-183

[nedaKaighobadi]

👀 Live preview

https://directories--docs-codacy.netlify.app/repositories/files/

🚧 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

[github-actions]

Overall readability score: 54.27 (🔴 -0.03)

File	Readability
files.md	71.77 (🔴 -1.94)
obtaining-code-quality-metrics-for-files.md	44.8 (🔴 -4.96)

View detailed metrics

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

File	Readability	FRE	GF	ARI	CLI	DCRS
files.md	71.77	56.15	9.08	9.4	10.03	6.48
	🔴 -1.94	🔴 -1.22	🔴 -0.42	🔴 -0.6	🔴 -0.06	🔴 -0.02
obtaining-code-quality-metrics-for-files.md	44.8	36.39	13.31	12.2	11.95	9.49
	🔴 -4.96	🔴 -8.96	🔴 -0.59	🔴 -0.7	🔴 -0.53	🔴 -0.22

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	54.27	43.28	10.89	12.3	12.24	8.02
	🔴 -0.03	🔴 -0.04	🟢 +0	🔴 -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]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

AI Reviewer: first review requested successfully. AI can make mistakes. Always validate suggestions.

_{TIP This summary will be updated as you push new changes.}

[gemini-code-assist]

Code Review

This pull request updates the documentation for the Files page to include details about browsing by folder and directory-level quality metrics. A review comment correctly identified an incorrect API documentation link for directory-level metrics, which should be updated to point to the correct file.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[codacy-production]

Pull Request Overview

The documentation updates successfully introduce folder-level navigation and metric aggregation concepts as intended. However, there are technical inaccuracies that should be addressed before merging, specifically regarding API documentation links.

Additionally, there is a significant discrepancy between the linked Jira ticket (which pertains to customer feedback segments) and the PR content (which is documentation for directory-level metrics). The PR description is currently empty, which lacks necessary context for reviewers.

About this PR

• There is a significant misalignment between the Jira ticket OD-183/ODIN-183 and the actual changes. The ticket appears to focus on 'customer feedback segments,' whereas this PR provides documentation for directory-level metrics. Please verify the ticket reference.
• The PR description is empty and the template checkboxes have not been completed. Please provide a summary of changes to assist with the review process and documentation history.

Test suggestions

• Verify the 'Browsing by folder' section correctly describes navigation and the directory summary bar.
• Verify each quality metric (Grade, Issues, etc.) has a clear definition for its folder-level aggregated value.
• Verify the note section correctly links to API documentation for directory metrics.

_{TIP Improve review quality by adding custom instructions
TIP How was this review? Give us feedback}