Add content for the org-level code quality dashboard (#59713)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Laura Coursen <lecoursen@github.com>

Author: 3 people

content/code-security/concepts/about-code-quality.md

@@ -28,6 +28,7 @@ With {% data variables.product.prodname_code_quality_short %}, you can:
 * Identify code quality risks and opportunities in **pull requests** and through **repository scans**.
 * Review clear explanations for findings and apply one-click **{% data variables.product.prodname_copilot_short %}-powered autofixes**.
 * Use **repository dashboards** to track reliability and maintainability scores, identify areas needing attention, and prioritize remediation.
+* Monitor **organization dashboards** to understand the code health of your repositories at a glance and determine which repositories to investigate further.
 * Set up **rulesets** for pull requests to enforce code quality standards and block changes that do not meet your criteria.
 * Easily assign remediation work to **{% data variables.copilot.copilot_coding_agent %}**, if you have a {% data variables.product.prodname_copilot_short %} license.
 
@@ -49,7 +50,7 @@ With {% data variables.product.prodname_code_quality_short %}, you can:
 
 {% data variables.product.prodname_code_quality_short %} also performs AI-powered analysis with results displayed separately on the "**{% data variables.code-quality.recent_suggestions %}**" repository dashboard. Unlike the rule-based {% data variables.product.prodname_codeql %} analysis that scans the entire codebase and pull requests, this AI-powered analysis only examines files recently pushed to the default branch and may identify issues in languages beyond those listed above. For more information, see [AUTOTITLE](/code-security/code-quality/responsible-use/code-quality).
 
-## Understanding where {% data variables.product.prodname_code_quality_short %} findings appear after enablement
+## Where will findings appear?
 
 Once you enable {% data variables.product.prodname_code_quality_short %} for a repository, you'll see {% data variables.product.prodname_codeql %} scans for:
 
@@ -76,5 +77,5 @@ Each {% data variables.product.prodname_codeql %} analysis will use {% data vari
 
 ## Next steps
 
-* Enable {% data variables.product.prodname_code_quality_short %} for your repository, see [AUTOTITLE](/code-security/code-quality/how-tos/enable-code-quality). Enterprise owners **may** need to first update their Advanced Security policies, see [AUTOTITLE](/code-security/code-quality/how-tos/allow-in-enterprise)
+* Enable {% data variables.product.prodname_code_quality_short %} for your repository, see [AUTOTITLE](/code-security/code-quality/how-tos/enable-code-quality). Enterprise owners **may** need to first update their Advanced Security policies, see [AUTOTITLE](/code-security/code-quality/how-tos/allow-in-enterprise).
 * See how {% data variables.product.prodname_code_quality %} works on your default branch to surface code quality issues and help you understand your repository's code health at a glance. See [AUTOTITLE](/code-security/code-quality/get-started/quickstart).

content/code-security/how-tos/maintain-quality-code/enable-code-quality.md

@@ -41,5 +41,5 @@ redirect_from:
 
 ## Next steps
 
-* Learn about the code quality backlog for your repository. See [AUTOTITLE](/code-security/code-quality/how-tos/interpret-results).
-* Find and fix code quality issues before they reach your default branch. See [AUTOTITLE](/code-security/code-quality/tutorials/fix-findings-in-prs).
+* **For your repository:** Understand your code quality backlog in detail. See [AUTOTITLE](/code-security/code-quality/how-tos/interpret-results).
+* **For your organization:** Understand the code health of your repositories at a glance. See [AUTOTITLE](/code-security/how-tos/view-and-interpret-data/analyze-organization-data/explore-code-quality).

content/code-security/how-tos/secure-at-scale/configure-enterprise-security/configure-specific-tools/allow-github-code-quality-in-enterprise.md

@@ -37,4 +37,4 @@ For more information about policies for {% data variables.product.prodname_AS %}
 
 ## Next steps
 
-To see {% data variables.product.prodname_code_quality_short %} in action, turn the feature on for one or more repositories, [AUTOTITLE](/code-security/code-quality/how-tos/enable-code-quality).
+To see {% data variables.product.prodname_code_quality_short %} in action, turn the feature on for one or more repositories. See [AUTOTITLE](/code-security/code-quality/how-tos/enable-code-quality).

content/code-security/how-tos/view-and-interpret-data/analyze-organization-data/explore-code-quality.md

@@ -0,0 +1,53 @@
+---
+title: Exploring GitHub Code Quality results in your organization
+shortTitle: Explore code quality
+intro: Understand your organization's code health at a glance with the organization-level dashboard for {% data variables.product.prodname_code_quality_short %}.
+product: '{% data reusables.gated-features.code-quality-availability %}'
+permissions: 'Organization members'
+contentType: how-tos
+versions:
+  feature: code-quality
+topics:
+  - Code Quality
+---
+
+{% data reusables.code-quality.code-quality-preview-note %}
+
+## Prerequisites
+
+* If your organization belongs to an enterprise, an enterprise owner must enable {% data variables.product.prodname_code_quality_short %} for your organization. See [AUTOTITLE](/code-security/how-tos/secure-at-scale/configure-enterprise-security/configure-specific-tools/allow-github-code-quality-in-enterprise).
+* Your organization must have repositories with {% data variables.product.prodname_code_quality_short %} enabled. See [AUTOTITLE](/code-security/how-tos/maintain-quality-code/enable-code-quality).
+
+## Viewing code quality insights for your organization
+
+1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your organization. For example, from [https://github.com/settings/organizations](https://github.com/settings/organizations?ref_product=github&ref_type=engagement&ref_style=text).
+{% data reusables.organizations.security-overview %}
+1. In the "Metrics" section of the sidebar, click {% octicon "code-square" aria-hidden="true" aria-label="code-square" %} **Code quality**.
+
+> [!NOTE] The dashboard only displays data for repositories where the viewer can see code quality findings.
+
+## Interpreting the score distribution chart
+
+The score distribution chart provides a visual overview of the code health of your organization. Each bubble represents a collection of repositories with the same maintainability and reliability scores.
+* The **position** of each bubble demonstrates the overall health of those repositories. Higher bubbles represent higher maintainability scores, while bubbles further to the right represent higher reliability scores.
+* The **color and border pattern** of a bubble indicate the severity of the lower score for those repositories. For example, a bubble with a "Needs improvement" score in either category will always be red with a dashed border.
+* The **size** of each bubble represents the number of repositories with that particular score combination.
+
+To view the maintainability score, reliability score, and number of repositories represented by a particular bubble, hover over the bubble.
+
+## Exploring the repository table
+
+Below the bubble chart, there is a table that lists all repositories in your organization. Here, you can view code quality findings, along with more detailed information about those findings.
+
+You can sort the repository table in ascending or descending order for any column by clicking the column header.
+
+## Investigating low-scoring repositories
+
+1. To filter the dashboard data for the lowest-performing repositories, on the score distribution chart, click the bubble with the lowest combined scores.
+1. Scroll down to the repository table. By default, the table is sorted from most to least recent repository scan, helping you prioritize current quality issues.
+1. Optionally, to prioritize repositories with the highest number of {% data variables.product.prodname_codeql %} findings, click **Standard Findings** twice.
+1. To view the repository-level dashboard for a specific repository, click the repository's name.
+
+## Next steps
+
+To understand the code health information available on the repository-level dashboard, see [AUTOTITLE](/code-security/how-tos/maintain-quality-code/interpret-results).

content/code-security/how-tos/view-and-interpret-data/analyze-organization-data/index.md

@@ -18,6 +18,7 @@ contentType: how-tos
 children:
   - /assessing-code-security-risk
   - /assessing-adoption-code-security
+  - /explore-code-quality
   - /exporting-data-from-security-overview
   - /viewing-security-insights
   - /interpreting-security-findings

content/code-security/tutorials/improve-code-quality/index.md

@@ -15,4 +15,3 @@ children:
 redirect_from:
   - /code-security/code-quality/tutorials
 ---
-

data/reusables/gated-features/code-quality-availability.md

@@ -1,3 +1,3 @@
 {% ifversion fpt or ghec %}
-{% data variables.product.prodname_code_quality %} is available for organization-owned repositories on {% data variables.product.prodname_team %} or {% data variables.product.prodname_ghe_cloud %}
+{% data variables.product.prodname_team %} or {% data variables.product.prodname_ghe_cloud %}
 {% endif %}