[EDI] Create a new "Code Quality" map topic within "Reference" (#59160)

sophietheking · web-flow · commit 2a0a31f64ed2 · 2026-01-15T11:25:03.000Z
diff --git a/content/code-security/code-quality/index.md b/content/code-security/code-quality/index.md
@@ -8,5 +8,4 @@ topics:
   - Code Quality
 children:
   - /get-started
-  - /reference
 ---
diff --git a/content/code-security/code-quality/reference/codeql-queries/index.md b/content/code-security/code-quality/reference/codeql-queries/index.md
diff --git a/content/code-security/code-quality/reference/index.md b/content/code-security/code-quality/reference/index.md
diff --git a/content/code-security/reference/code-quality/codeql-detection.md b/content/code-security/reference/code-quality/codeql-detection.md
@@ -2,12 +2,14 @@
 title: CodeQL-powered analysis for Code Quality
 shortTitle: CodeQL analysis
 allowTitleToDifferFromFilename: true
-intro: 'Information on how CodeQL-powered analysis for {% data variables.product.prodname_code_quality_short %} works, the workflow used, and the status checks reported on pull requests.'
+intro: Information on how CodeQL-powered analysis for {% data variables.product.prodname_code_quality_short %} works, the workflow used, and the status checks reported on pull requests.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/codeql-detection
 ---
 
 {% data reusables.code-quality.code-quality-preview-note %}
diff --git a/content/code-security/reference/code-quality/codeql-queries/csharp-queries.md b/content/code-security/reference/code-quality/codeql-queries/csharp-queries.md
@@ -2,12 +2,14 @@
 title: C# CodeQL queries for Code Quality
 shortTitle: C# queries
 allowTitleToDifferFromFilename: true
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in C#.'
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in C#.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/codeql-queries/csharp-queries
 ---
 
 {% data variables.product.prodname_code_quality_short %} uses the following {% data variables.product.prodname_codeql %} queries to analyze C# code and detect code quality issues on:
@@ -17,4 +19,4 @@ contentType: reference
 
 {% data variables.copilot.copilot_autofix_short %} suggestions are provided for findings where possible.
 
-{% data reusables.code-quality.codeql-query-tables.csharp %}
+{% data reusables.code-quality.codeql-query-tables.csharp %}
diff --git a/content/code-security/reference/code-quality/codeql-queries/go-queries.md b/content/code-security/reference/code-quality/codeql-queries/go-queries.md
@@ -1,12 +1,14 @@
 ---
 title: Go CodeQL queries for Code Quality
 shortTitle: Go queries
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Go.'
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Go.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/codeql-queries/go-queries
 ---
 
 {% data variables.product.prodname_code_quality_short %} uses the following {% data variables.product.prodname_codeql %} queries to analyze Go code and detect code quality issues on:
@@ -16,4 +18,4 @@ contentType: reference
 
 {% data variables.copilot.copilot_autofix_short %} suggestions are provided for findings where possible.
 
-{% data reusables.code-quality.codeql-query-tables.go %}
+{% data reusables.code-quality.codeql-query-tables.go %}
diff --git a/content/code-security/reference/code-quality/codeql-queries/index.md b/content/code-security/reference/code-quality/codeql-queries/index.md
@@ -0,0 +1,23 @@
+---
+title: Reference for CodeQL queries
+shortTitle: CodeQL queries
+intro: Find lists of CodeQL queries used by {% data variables.product.prodname_code_quality_short %} for each supported programming language.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+topics:
+  - Code Security
+  - Code scanning
+  - Vulnerabilities
+contentType: reference
+children:
+  - /csharp-queries
+  - /go-queries
+  - /java-queries
+  - /javascript-queries
+  - /python-queries
+  - /ruby-queries
+redirect_from:
+  - /code-security/code-quality/reference/codeql-queries
+---
diff --git a/content/code-security/reference/code-quality/codeql-queries/java-queries.md b/content/code-security/reference/code-quality/codeql-queries/java-queries.md
@@ -2,12 +2,14 @@
 title: Java CodeQL queries for Code Quality
 shortTitle: Java queries
 allowTitleToDifferFromFilename: true
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Java.'
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Java.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/codeql-queries/java-queries
 ---
 
 {% data variables.product.prodname_code_quality_short %} uses the following {% data variables.product.prodname_codeql %} queries to analyze Java code and detect code quality issues on:
diff --git a/content/code-security/reference/code-quality/codeql-queries/javascript-queries.md b/content/code-security/reference/code-quality/codeql-queries/javascript-queries.md
@@ -2,12 +2,14 @@
 title: JavaScript CodeQL queries for Code Quality
 shortTitle: JavaScript queries
 allowTitleToDifferFromFilename: true
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in JavaScript.'
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in JavaScript.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/codeql-queries/javascript-queries
 ---
 
 {% data variables.product.prodname_code_quality_short %} uses the following {% data variables.product.prodname_codeql %} queries to analyze JavaScript code and detect code quality issues on:
diff --git a/content/code-security/reference/code-quality/codeql-queries/python-queries.md b/content/code-security/reference/code-quality/codeql-queries/python-queries.md
@@ -2,12 +2,14 @@
 title: Python CodeQL queries for Code Quality
 shortTitle: Python queries
 allowTitleToDifferFromFilename: true
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Python.'
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Python.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/codeql-queries/python-queries
 ---
 
 {% data variables.product.prodname_code_quality_short %} uses the following {% data variables.product.prodname_codeql %} queries to analyze Python code and detect code quality issues on:
diff --git a/content/code-security/reference/code-quality/codeql-queries/ruby-queries.md b/content/code-security/reference/code-quality/codeql-queries/ruby-queries.md
@@ -2,12 +2,14 @@
 title: Ruby CodeQL queries for Code Quality
 shortTitle: Ruby queries
 allowTitleToDifferFromFilename: true
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Ruby.'
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code quality for code written in Ruby.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/codeql-queries/ruby-queries
 ---
 
 {% data variables.product.prodname_code_quality_short %} uses the following {% data variables.product.prodname_codeql %} queries to analyze Ruby code and detect code quality issues on:
diff --git a/content/code-security/reference/code-quality/index.md b/content/code-security/reference/code-quality/index.md
@@ -0,0 +1,18 @@
+---
+title: Reference for code quality
+shortTitle: Code quality
+intro: Find reference documentation for {% data variables.product.prodname_code_quality_short %}.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+topics:
+  - Code Quality
+contentType: reference
+children:
+  - /metrics-and-ratings
+  - /codeql-detection
+  - /codeql-queries
+redirect_from:
+  - /code-security/code-quality/reference
+---
diff --git a/content/code-security/reference/code-quality/metrics-and-ratings.md b/content/code-security/reference/code-quality/metrics-and-ratings.md
@@ -1,12 +1,14 @@
 ---
 title: Metrics and ratings reference
 shortTitle: Metrics and ratings
-intro: 'Understand the terminology used by {% data variables.product.github %} to assess the quality of your repository''s code.'
+intro: Understand the terminology used by {% data variables.product.github %} to assess the quality of your repository's code.
 versions:
   feature: code-quality
 topics:
   - Code Quality
 contentType: reference
+redirect_from:
+  - /code-security/code-quality/reference/metrics-and-ratings
 ---
 
 {% data reusables.code-quality.code-quality-preview-note %}
diff --git a/content/code-security/reference/index.md b/content/code-security/reference/index.md
@@ -19,5 +19,6 @@ children:
   - /secret-security
   - /code-scanning
   - /supply-chain-security
+  - /code-quality
   - /permission-levels-for-repository-security-advisories
 ---
