[EDI] Create a new "Code scanning" map topic within "Concepts" (#59056)

sophietheking · isaacmbrown · web-flow · commit f62bb9f0c63c · 2026-01-09T09:23:31.000Z
Co-authored-by: Isaac Brown &lt;101839405+isaacmbrown@users.noreply.github.com&gt;
diff --git a/content/code-security/code-scanning/enabling-code-scanning/index.md b/content/code-security/code-scanning/enabling-code-scanning/index.md
@@ -1,7 +1,7 @@
 ---
 title: Enabling code scanning
 shortTitle: Enable code scanning
-intro: 'You can quickly and easily secure your code with default setup for {% data variables.product.prodname_code_scanning %}.'
+intro: You can quickly and easily secure your code with default setup for {% data variables.product.prodname_code_scanning %}.
 product: '{% data reusables.gated-features.code-scanning %}'
 versions:
   fpt: '*'
@@ -13,6 +13,6 @@ topics:
   - CodeQL
 children:
   - /configuring-default-setup-for-code-scanning
-  - /evaluating-default-setup-for-code-scanning
   - /configuring-default-setup-for-code-scanning-at-scale
 ---
+
diff --git a/content/code-security/code-scanning/index.md b/content/code-security/code-scanning/index.md
@@ -17,7 +17,6 @@ topics:
   - Code scanning
   - CodeQL
 children:
-  - /introduction-to-code-scanning
   - /enabling-code-scanning
   - /creating-an-advanced-setup-for-code-scanning
   - /managing-code-scanning-alerts
diff --git a/content/code-security/code-scanning/integrating-with-code-scanning/index.md b/content/code-security/code-scanning/integrating-with-code-scanning/index.md
@@ -1,7 +1,7 @@
 ---
 title: Integrating with code scanning
 shortTitle: Integrate with code scanning
-intro: 'You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.'
+intro: You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.
 product: '{% data reusables.gated-features.code-scanning %}'
 redirect_from:
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning
@@ -16,8 +16,8 @@ topics:
   - Code scanning
   - Integration
 children:
-  - /about-integration-with-code-scanning
   - /using-code-scanning-with-your-existing-ci-system
   - /uploading-a-sarif-file-to-github
   - /sarif-support-for-code-scanning
 ---
+
diff --git a/content/code-security/code-scanning/introduction-to-code-scanning/index.md b/content/code-security/code-scanning/introduction-to-code-scanning/index.md
diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/index.md b/content/code-security/code-scanning/managing-code-scanning-alerts/index.md
@@ -1,7 +1,7 @@
 ---
 title: Managing code scanning alerts
 shortTitle: Manage alerts
-intro: 'Learn how to triage, track, and resolve {% data variables.product.prodname_code_scanning %} alerts.'
+intro: Learn how to triage, track, and resolve {% data variables.product.prodname_code_scanning %} alerts.
 product: '{% data reusables.gated-features.code-scanning %}'
 versions:
   fpt: '*'
@@ -15,7 +15,6 @@ redirect_from:
   - /code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists
   - /code-security/code-scanning/managing-code-scanning-alerts/tracking-code-scanning-alerts-in-issues-using-task-lists
 children:
-  - /about-code-scanning-alerts
   - /responsible-use-autofix-code-scanning
   - /disabling-autofix-for-code-scanning
   - /assessing-code-scanning-alerts-for-your-repository
@@ -24,3 +23,4 @@ children:
   - /fixing-alerts-in-security-campaign
   - /triaging-code-scanning-alerts-in-pull-requests
 ---
+
diff --git a/content/code-security/code-scanning/managing-your-code-scanning-configuration/index.md b/content/code-security/code-scanning/managing-your-code-scanning-configuration/index.md
@@ -14,7 +14,6 @@ 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
   - /configuring-larger-runners-for-default-setup
diff --git a/content/code-security/codeql-cli/getting-started-with-the-codeql-cli/index.md b/content/code-security/codeql-cli/getting-started-with-the-codeql-cli/index.md
@@ -1,6 +1,6 @@
 ---
 title: Getting started with the CodeQL CLI
-intro: 'You can use the {% data variables.product.prodname_codeql_cli %} to locally develop, test and run {% data variables.product.prodname_codeql %} queries on software projects.'
+intro: You can use the {% data variables.product.prodname_codeql_cli %} to locally develop, test and run {% data variables.product.prodname_codeql %} queries on software projects.
 shortTitle: Getting started
 product: '{% data reusables.gated-features.codeql %}'
 versions:
@@ -12,7 +12,6 @@ topics:
   - Code scanning
   - CodeQL
 children:
-  - /about-the-codeql-cli
   - /setting-up-the-codeql-cli
   - /preparing-your-code-for-codeql-analysis
   - /analyzing-your-code-with-codeql-queries
@@ -21,3 +20,4 @@ children:
 redirect_from:
   - /code-security/codeql-cli/using-the-codeql-cli
 ---
+
diff --git a/content/code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/index.md b/content/code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/index.md
@@ -1,6 +1,6 @@
 ---
 title: Using the advanced functionality of the CodeQL CLI
-intro: 'You can use the {% data variables.product.prodname_codeql_cli %} to locally develop, test and run {% data variables.product.prodname_codeql %} queries on software projects.'
+intro: You can use the {% data variables.product.prodname_codeql_cli %} to locally develop, test and run {% data variables.product.prodname_codeql %} queries on software projects.
 product: '{% data reusables.gated-features.codeql %}'
 shortTitle: Advanced functionality
 versions:
@@ -13,15 +13,13 @@ topics:
   - CodeQL
 children:
   - /advanced-setup-of-the-codeql-cli
-  - /about-codeql-workspaces
   - /using-custom-queries-with-the-codeql-cli
   - /creating-codeql-query-suites
   - /testing-custom-queries
   - /testing-query-help-files
   - /creating-and-working-with-codeql-packs
   - /publishing-and-using-codeql-packs
   - /specifying-command-options-in-a-codeql-configuration-file
-  - /query-reference-files
   - /sarif-output
   - /csv-output
   - /extractor-options
@@ -30,3 +28,4 @@ children:
 redirect_from:
   - /code-security/codeql-cli/codeql-cli-reference
 ---
+
diff --git a/content/code-security/codeql-for-vs-code/getting-started-with-codeql-for-vs-code/index.md b/content/code-security/codeql-for-vs-code/getting-started-with-codeql-for-vs-code/index.md
@@ -1,7 +1,7 @@
 ---
 title: Getting started with the {% data variables.product.prodname_codeql %} for Visual Studio Code extension
 shortTitle: Getting started
-intro: 'The {% data variables.product.prodname_codeql %} extension for {% data variables.product.prodname_vscode %} makes it easy to run a query to find problems in codebases.'
+intro: The {% data variables.product.prodname_codeql %} extension for {% data variables.product.prodname_vscode %} makes it easy to run a query to find problems in codebases.
 product: '{% data reusables.gated-features.codeql %}'
 versions:
   fpt: '*'
@@ -12,7 +12,6 @@ topics:
   - Code scanning
   - CodeQL
 children:
-  - /about-codeql-for-vs-code
   - /installing-codeql-for-vs-code
   - /managing-codeql-databases
   - /running-codeql-queries
@@ -21,3 +20,4 @@ children:
 redirect_from:
   - /code-security/codeql-for-vs-code/setting-up-codeql-in-visual-studio-code
 ---
+
diff --git a/content/code-security/concepts/code-scanning/about-code-scanning-alerts.md b/content/code-security/concepts/code-scanning/about-code-scanning-alerts.md
@@ -1,5 +1,6 @@
 ---
 title: About code scanning alerts
+shortTitle: Code scanning alerts
 intro: Learn about the different types of code scanning alerts and the information that helps you understand the problem each alert highlights.
 permissions: '{% data reusables.permissions.code-scanning-all-alerts %}'
 product: '{% data reusables.gated-features.code-scanning %}'
@@ -9,11 +10,13 @@ versions:
   ghec: '*'
 redirect_from:
   - /code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-alerts
+  - /code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts
 type: overview
 topics:
   - Code Security
   - Code scanning
   - CodeQL
+contentType: concepts
 ---
 
 {% data reusables.code-scanning.enterprise-enable-code-scanning %}
diff --git a/content/code-security/concepts/code-scanning/about-code-scanning.md b/content/code-security/concepts/code-scanning/about-code-scanning.md
@@ -1,6 +1,7 @@
 ---
 title: About code scanning
-intro: 'You can use {% data variables.product.prodname_code_scanning %} to find security vulnerabilities and errors in the code for your project on {% data variables.product.prodname_dotcom %}.'
+shortTitle: Introduction
+intro: You can use {% data variables.product.prodname_code_scanning %} to find security vulnerabilities and errors in the code for your project on {% data variables.product.prodname_dotcom %}.
 product: '{% data reusables.gated-features.code-scanning %}'
 redirect_from:
   - /github/managing-security-vulnerabilities/about-automated-code-scanning
@@ -9,6 +10,7 @@ redirect_from:
   - /code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning
   - /code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning
+  - /code-security/code-scanning/introduction-to-code-scanning/about-code-scanning
 versions:
   fpt: '*'
   ghes: '*'
@@ -17,6 +19,7 @@ type: overview
 topics:
   - Code Security
   - Code scanning
+contentType: concepts
 ---
 
 {% data reusables.code-scanning.enterprise-enable-code-scanning %}
diff --git a/content/code-security/concepts/code-scanning/about-integration-with-code-scanning.md b/content/code-security/concepts/code-scanning/about-integration-with-code-scanning.md
@@ -1,13 +1,14 @@
 ---
 title: About integration with code scanning
-shortTitle: About integration
-intro: 'You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}, or configure webhooks that listen to {% data variables.product.prodname_code_scanning %} activity in your repository.'
+shortTitle: Integration with code scanning
+intro: You can perform {% data variables.product.prodname_code_scanning %} externally and then display the results in {% data variables.product.prodname_dotcom %}, or configure webhooks that listen to {% data variables.product.prodname_code_scanning %} activity in your repository.
 product: '{% data reusables.gated-features.code-scanning %}'
 redirect_from:
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/about-integration-with-code-scanning
   - /code-security/secure-coding/about-integration-with-code-scanning
   - /code-security/secure-coding/integrating-with-code-scanning/about-integration-with-code-scanning
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning/about-integration-with-code-scanning
+  - /code-security/code-scanning/integrating-with-code-scanning/about-integration-with-code-scanning
 versions:
   fpt: '*'
   ghes: '*'
@@ -18,6 +19,7 @@ topics:
   - Code scanning
   - Webhooks
   - Integration
+contentType: concepts
 ---
 
 ## About integration with code scanning
diff --git a/content/code-security/concepts/code-scanning/codeql/about-code-scanning-with-codeql.md b/content/code-security/concepts/code-scanning/codeql/about-code-scanning-with-codeql.md
@@ -1,11 +1,12 @@
 ---
 title: About code scanning with CodeQL
-shortTitle: About CodeQL code scanning
-intro: 'You can use {% data variables.product.prodname_codeql %} to identify vulnerabilities and errors in your code. The results are shown as {% data variables.product.prodname_code_scanning %} alerts in {% data variables.product.prodname_dotcom %}.'
+shortTitle: CodeQL code scanning
+intro: You can use {% data variables.product.prodname_codeql %} to identify vulnerabilities and errors in your code. The results are shown as {% data variables.product.prodname_code_scanning %} alerts in {% data variables.product.prodname_dotcom %}.
 product: '{% data reusables.gated-features.code-scanning %}'
 redirect_from:
   - /code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql
   - /code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql
+  - /code-security/code-scanning/introduction-to-code-scanning/about-code-scanning-with-codeql
 versions:
   fpt: '*'
   ghes: '*'
@@ -15,6 +16,7 @@ topics:
   - Code Security
   - Code scanning
   - CodeQL
+contentType: concepts
 ---
 
 {% data reusables.code-scanning.enterprise-enable-code-scanning %}
diff --git a/content/code-security/concepts/code-scanning/codeql/about-codeql-for-vs-code.md b/content/code-security/concepts/code-scanning/codeql/about-codeql-for-vs-code.md
@@ -1,6 +1,6 @@
 ---
 title: About CodeQL for VS Code
-shortTitle: About the extension
+shortTitle: CodeQL for VS Code
 versions:
   fpt: '*'
   ghec: '*'
@@ -11,9 +11,11 @@ topics:
   - Code scanning
   - CodeQL
 type: reference
-intro: 'You can write, run, and test {% data variables.product.prodname_codeql %} queries inside {% data variables.product.prodname_vscode %} with the {% data variables.product.prodname_codeql %} extension.'
+intro: You can write, run, and test {% data variables.product.prodname_codeql %} queries inside {% data variables.product.prodname_vscode %} with the {% data variables.product.prodname_codeql %} extension.
 redirect_from:
   - /code-security/codeql-for-vs-code/about-codeql-for-visual-studio-code
+  - /code-security/codeql-for-vs-code/getting-started-with-codeql-for-vs-code/about-codeql-for-vs-code
+contentType: concepts
 ---
 
 ## About {% data variables.product.prodname_codeql %} for {% data variables.product.prodname_vscode %}
diff --git a/content/code-security/concepts/code-scanning/codeql/about-codeql-workspaces.md b/content/code-security/concepts/code-scanning/codeql/about-codeql-workspaces.md
@@ -1,5 +1,6 @@
 ---
 title: About CodeQL workspaces
+shortTitle: CodeQL workspaces
 intro: '{% data variables.product.prodname_codeql %} workspaces allow you to develop and maintain a group of {% data variables.product.prodname_codeql %} packs that depend on each other.'
 product: '{% data reusables.gated-features.codeql %}'
 versions:
@@ -13,6 +14,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/about-codeql-workspaces
   - /code-security/codeql-cli/codeql-cli-reference/about-codeql-workspaces
+  - /code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/about-codeql-workspaces
+contentType: concepts
 ---
 
 ## About {% data variables.product.prodname_codeql %} workspaces
diff --git a/content/code-security/concepts/code-scanning/codeql/about-the-codeql-cli.md b/content/code-security/concepts/code-scanning/codeql/about-the-codeql-cli.md
@@ -1,6 +1,7 @@
 ---
 title: About the CodeQL CLI
-intro: 'You can use the {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_codeql %} processes locally on software projects or to generate {% data variables.product.prodname_code_scanning %} results for upload to {% data variables.product.github %}.'
+shortTitle: CodeQL CLI
+intro: You can use the {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_codeql %} processes locally on software projects or to generate {% data variables.product.prodname_code_scanning %} results for upload to {% data variables.product.github %}.
 product: '{% data reusables.gated-features.codeql %}'
 versions:
   fpt: '*'
@@ -22,6 +23,8 @@ redirect_from:
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system/troubleshooting-codeql-code-scanning-in-your-ci-system
   - /code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli
   - /code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system
+  - /code-security/codeql-cli/getting-started-with-the-codeql-cli/about-the-codeql-cli
+contentType: concepts
 ---
 
 Software developers and security researchers can secure their code
diff --git a/content/code-security/concepts/code-scanning/codeql/codeql-query-suites.md b/content/code-security/concepts/code-scanning/codeql/codeql-query-suites.md
@@ -10,11 +10,12 @@ versions:
 redirect_from:
   - /code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/built-in-codeql-query-suites
   - /code-security/code-scanning/managing-your-code-scanning-configuration/built-in-codeql-query-suites
+  - /code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites
 type: reference
 topics:
   - Code scanning
   - CodeQL
-contentType: other
+contentType: concepts
 ---
 
 ## About {% data variables.product.prodname_codeql %} query suites
diff --git a/content/code-security/concepts/code-scanning/codeql/index.md b/content/code-security/concepts/code-scanning/codeql/index.md
@@ -0,0 +1,19 @@
+---
+title: Concepts for CodeQL
+shortTitle: CodeQL
+intro: Understand the core concepts behind {% data variables.product.prodname_codeql %} and how it helps you find vulnerabilities and errors in your code.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+topics:
+  - Code scanning
+contentType: concepts
+children:
+  - /about-code-scanning-with-codeql
+  - /codeql-query-suites
+  - /about-the-codeql-cli
+  - /about-codeql-for-vs-code
+  - /about-codeql-workspaces
+  - /query-reference-files
+---
diff --git a/content/code-security/concepts/code-scanning/codeql/query-reference-files.md b/content/code-security/concepts/code-scanning/codeql/query-reference-files.md
@@ -13,6 +13,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/query-reference-files
   - /code-security/codeql-cli/codeql-cli-reference/query-reference-files
+  - /code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/query-reference-files
+contentType: concepts
 ---
 
 ## About query reference files
diff --git a/content/code-security/concepts/code-scanning/evaluating-default-setup-for-code-scanning.md b/content/code-security/concepts/code-scanning/evaluating-default-setup-for-code-scanning.md
@@ -1,7 +1,7 @@
 ---
 title: Evaluating default setup for code scanning
 shortTitle: Evaluate code scanning
-intro: 'Learn how to assess how code scanning is working for you, and how you can customize your setup to best meet your needs.'
+intro: Learn how to assess how code scanning is working for you, and how you can customize your setup to best meet your needs.
 permissions: '{% data reusables.permissions.security-repo-enable %}'
 type: how_to
 topics:
@@ -11,6 +11,9 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+redirect_from:
+  - /code-security/code-scanning/enabling-code-scanning/evaluating-default-setup-for-code-scanning
+contentType: concepts
 ---
 
 When you first start using {% data variables.product.prodname_code_scanning %}, you'll likely use default setup. This guide describes how to evaluate how default setup for {% data variables.product.prodname_code_scanning %} is working for you, and what steps to take if something isn't working as you expect. This guide also describes how you can customize {% data variables.product.prodname_code_scanning %} if you find that you have a specific use case that your new configuration doesn't fit.
diff --git a/content/code-security/concepts/code-scanning/index.md b/content/code-security/concepts/code-scanning/index.md
diff --git a/content/code-security/concepts/index.md b/content/code-security/concepts/index.md
diff --git a/data/learning-tracks/code-security.yml b/data/learning-tracks/code-security.yml
