[Improvement]: Create "Reference" category for code scanning for CodeQL queries #20670 (#58874)

Co-authored-by: hubwriter <[email protected]>

Author: am-stead

content/code-security/code-scanning/index.md

@@ -25,4 +25,5 @@ children:
   - /integrating-with-code-scanning
   - /troubleshooting-code-scanning
   - /troubleshooting-sarif-uploads
+  - /reference
 ---

content/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests.md

@@ -127,7 +127,7 @@ Anyone with push access to a pull request can fix a {% data variables.product.pr
 When {% data variables.copilot.copilot_autofix_short %} is enabled for a repository, alerts are displayed in pull requests as normal and information from any alerts found by {% data variables.product.prodname_code_scanning %} is automatically sent to the LLM for processing. When LLM analysis is complete, any results are published as comments on relevant alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning).
 
 > [!NOTE]
-> * {% data variables.copilot.copilot_autofix_short %} supports a subset of {% data variables.product.prodname_codeql %} queries. For information about the availability of {% data variables.copilot.copilot_autofix_short %}, see the query tables linked from [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites#query-lists-for-the-default-query-suites).
+> * {% data variables.copilot.copilot_autofix_short %} supports a subset of {% data variables.product.prodname_codeql %} queries. For information about the availability of {% data variables.copilot.copilot_autofix_short %}, see the query tables linked from [AUTOTITLE](/code-security/code-scanning/reference/code-ql-built-in-queries).
 > * When analysis is complete, all relevant results are published to the pull request at once. If at least one alert in your pull request has an {% data variables.copilot.copilot_autofix_short %} suggestion, you should assume that the LLM has finished identifying potential fixes for your code.
 > * On alerts generated from queries that are not supported by {% data variables.copilot.copilot_autofix_short %}, you will see a note telling you that the query is not supported. If a suggestion for a supported query fails to generate, you will see a note on the alert prompting you to try pushing another commit or to contact support.
 > * {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %} alerts won't be able to generate a fix for every alert in every situation. The feature operates on a best-effort basis and is not guaranteed to succeed 100% of the time. For information about the limitations of automatically generated fixes, see [Limitations of suggestions](/code-security/code-scanning/managing-code-scanning-alerts/about-autofix-for-codeql-code-scanning#limitations-of-suggestions).

content/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites.md

@@ -1,7 +1,7 @@
 ---
 title: CodeQL query suites
 shortTitle: CodeQL query suites
-intro: 'You can choose from different built-in {% data variables.product.prodname_codeql %} query suites to use in your {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} setup.'
+intro: You can choose from different built-in {% data variables.product.prodname_codeql %} query suites to use in your {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} setup.
 product: '{% data reusables.gated-features.codeql %}'
 versions:
   fpt: '*'
@@ -14,6 +14,7 @@ type: reference
 topics:
   - Code scanning
   - CodeQL
+contentType: other
 ---
 
 ## About {% data variables.product.prodname_codeql %} query suites
@@ -43,11 +44,7 @@ The built-in {% data variables.product.prodname_codeql %} query suites, `default
 * Relative to the `default` query suite, the `security-extended` suite may return a greater number of false positive {% data variables.product.prodname_code_scanning %} results.
 * This query suite is available for use with default setup for {% data variables.product.prodname_code_scanning %}, and is referred to as the "Extended" query suite on {% data variables.product.prodname_dotcom %}.
 
-## Query lists for the default query suites
-
-For each language, the following article lists which queries are included in the `default` and the `security-extended` suites. {% ifversion code-scanning-autofix %}Where {% data variables.copilot.copilot_autofix_short %} is available for a language, details of which queries are supported are also included.{% endif %}
-
-{% data reusables.code-scanning.codeql-query-tables.links-to-all-tables %}
+For a complete list of queries included in each query suite for every language, see [AUTOTITLE](/code-security/code-scanning/reference).
 
 ## Further reading
 

content/code-security/code-scanning/managing-your-code-scanning-configuration/github-actions-built-in-queries.md

@@ -1,7 +1,7 @@
 ---
 title: Managing your code scanning configuration
 shortTitle: Manage code scanning
-intro: 'You can manage your existing {% data variables.product.prodname_code_scanning %} configuration with the help of metrics and logging outputs generated by your analysis.'
+intro: You can manage your existing {% data variables.product.prodname_code_scanning %} configuration with the help of metrics and logging outputs generated by your analysis.
 product: '{% data reusables.gated-features.code-scanning %}'
 versions:
   fpt: '*'
@@ -14,20 +14,10 @@ topics:
 children:
   - /about-the-tool-status-page
   - /editing-your-configuration-of-default-setup
+  - /codeql-query-suites
   - /set-code-scanning-merge-protection
   - /enabling-delegated-alert-dismissal-for-code-scanning
-  - /codeql-query-suites
   - /configuring-larger-runners-for-default-setup
   - /viewing-code-scanning-logs
-  - /actions-built-in-queries
-  - /c-cpp-built-in-queries
-  - /csharp-built-in-queries
-  - /github-actions-built-in-queries
-  - /go-built-in-queries
-  - /java-kotlin-built-in-queries
-  - /javascript-typescript-built-in-queries
-  - /python-built-in-queries
-  - /ruby-built-in-queries
-  - /rust-built-in-queries
-  - /swift-built-in-queries
 ---
+

content/code-security/code-scanning/managing-your-code-scanning-configuration/index.md

@@ -0,0 +1,25 @@
+---
+title: About built-in CodeQL queries
+shortTitle: About built-in queries
+allowTitleToDifferFromFilename: true
+intro: Learn about the CodeQL queries that code scanning uses to analyze code.
+product: '{% data reusables.gated-features.code-scanning %}'
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '*'
+type: overview
+topics:
+  - Code Security
+  - Code scanning
+  - CodeQL
+contentType: other
+---
+
+## About built-in queries for CodeQL analysis
+
+For each language, the following articles list which queries are included in the `default` and the `security-extended` suites. {% ifversion code-scanning-autofix %}Where {% data variables.copilot.copilot_autofix_short %} is available for a language, details of which queries are supported are also included.{% endif %}
+
+{% data reusables.code-scanning.codeql-query-tables.links-to-all-tables %}
+
+For more information about CodeQL query suites, see [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites).

content/code-security/code-scanning/reference/code-ql-built-in-queries/about-built-in-queries.md

@@ -1,7 +1,7 @@
 ---
-title: Actions queries for CodeQL analysis
-shortTitle: Actions CodeQL queries
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in {% data variables.product.prodname_actions %} workflow files when you select the `default` or the `security-extended` query suite.'
+title: GitHub Actions queries for CodeQL analysis
+shortTitle: Actions queries
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in {% data variables.product.prodname_actions %} workflow files when you select the `default` or the `security-extended` query suite.
 product: '{% data reusables.gated-features.codeql %}'
 allowTitleToDifferFromFilename: true
 versions:
@@ -12,6 +12,10 @@ type: reference
 topics:
   - Code scanning
   - CodeQL
+redirect_from:
+  - /code-security/code-scanning/managing-your-code-scanning-configuration/actions-built-in-queries
+  - /code-security/code-scanning/managing-your-code-scanning-configuration/github-actions-built-in-queries
+contentType: other
 ---
 
 {% data variables.product.prodname_codeql %} includes many queries for analyzing {% data variables.product.prodname_actions %} workflows. {% data reusables.code-scanning.codeql-query-tables.query-suite-behavior %}

…onfiguration/actions-built-in-queries.md …t-in-queries/actions-built-in-queries.mdcontent/code-security/code-scanning/managing-your-code-scanning-configuration/actions-built-in-queries.md renamed to content/code-security/code-scanning/reference/code-ql-built-in-queries/actions-built-in-queries.md content/code-security/code-scanning/managing-your-code-scanning-configuration/actions-built-in-queries.md renamed to content/code-security/code-scanning/reference/code-ql-built-in-queries/actions-built-in-queries.md

@@ -1,7 +1,7 @@
 ---
 title: C and C++ queries for CodeQL analysis
-shortTitle: C and C++ CodeQL queries
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in C or C++ when you select the `default` or the `security-extended` query suite.'
+shortTitle: C and C++ queries
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in C or C++ when you select the `default` or the `security-extended` query suite.
 product: '{% data reusables.gated-features.codeql %}'
 allowTitleToDifferFromFilename: true
 versions:
@@ -12,6 +12,9 @@ type: reference
 topics:
   - Code scanning
   - CodeQL
+redirect_from:
+  - /code-security/code-scanning/managing-your-code-scanning-configuration/c-cpp-built-in-queries
+contentType: other
 ---
 
 {% data variables.product.prodname_codeql %} includes many queries for analyzing C and C++ code. {% data reusables.code-scanning.codeql-query-tables.query-suite-behavior %}

…-configuration/c-cpp-built-in-queries.md …ilt-in-queries/c-cpp-built-in-queries.mdcontent/code-security/code-scanning/managing-your-code-scanning-configuration/c-cpp-built-in-queries.md renamed to content/code-security/code-scanning/reference/code-ql-built-in-queries/c-cpp-built-in-queries.md content/code-security/code-scanning/managing-your-code-scanning-configuration/c-cpp-built-in-queries.md renamed to content/code-security/code-scanning/reference/code-ql-built-in-queries/c-cpp-built-in-queries.md

@@ -1,7 +1,7 @@
 ---
 title: C# queries for CodeQL analysis
-shortTitle: C# CodeQL queries
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in C# when you select the `default` or the `security-extended` query suite.'
+shortTitle: C# queries
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in C# when you select the `default` or the `security-extended` query suite.
 product: '{% data reusables.gated-features.codeql %}'
 allowTitleToDifferFromFilename: true
 versions:
@@ -12,6 +12,9 @@ type: reference
 topics:
   - Code scanning
   - CodeQL
+redirect_from:
+  - /code-security/code-scanning/managing-your-code-scanning-configuration/csharp-built-in-queries
+contentType: other
 ---
 
 {% data variables.product.prodname_codeql %} includes many queries for analyzing C# code. {% data reusables.code-scanning.codeql-query-tables.query-suite-behavior %}

…configuration/csharp-built-in-queries.md …lt-in-queries/csharp-built-in-queries.mdcontent/code-security/code-scanning/managing-your-code-scanning-configuration/csharp-built-in-queries.md renamed to content/code-security/code-scanning/reference/code-ql-built-in-queries/csharp-built-in-queries.md content/code-security/code-scanning/managing-your-code-scanning-configuration/csharp-built-in-queries.md renamed to content/code-security/code-scanning/reference/code-ql-built-in-queries/csharp-built-in-queries.md

@@ -1,7 +1,7 @@
 ---
 title: Go queries for CodeQL analysis
-shortTitle: Go CodeQL queries
-intro: 'Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in Go (Golang) when you select the `default` or the `security-extended` query suite.'
+shortTitle: Go queries
+intro: Explore the queries that {% data variables.product.prodname_codeql %} uses to analyze code written in Go (Golang) when you select the `default` or the `security-extended` query suite.
 product: '{% data reusables.gated-features.codeql %}'
 allowTitleToDifferFromFilename: true
 versions:
@@ -12,6 +12,9 @@ type: reference
 topics:
   - Code scanning
   - CodeQL
+redirect_from:
+  - /code-security/code-scanning/managing-your-code-scanning-configuration/go-built-in-queries
+contentType: other
 ---
 
 {% data variables.product.prodname_codeql %} includes many queries for analyzing Go code. {% data reusables.code-scanning.codeql-query-tables.query-suite-behavior %}