[EDI] Create a new "Customize code scanning" map topic within "Tutorials" (#59119)

sophietheking · web-flow · commit 435d76b3a714 · 2026-01-13T13:47:28.000Z
diff --git a/content/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/index.md b/content/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/index.md
@@ -12,5 +12,4 @@ topics:
   - Code scanning
 children:
   - /recommended-hardware-resources-for-running-codeql
-  - /running-codeql-code-scanning-in-a-container
 ---
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
diff --git a/content/code-security/codeql-cli/index.md b/content/code-security/codeql-cli/index.md
@@ -13,7 +13,6 @@ topics:
   - Code scanning
   - CodeQL
 children:
-  - /getting-started-with-the-codeql-cli
   - /using-the-advanced-functionality-of-the-codeql-cli
   - /codeql-cli-manual
 ---
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
@@ -12,10 +12,6 @@ topics:
   - Code scanning
   - CodeQL
 children:
-  - /creating-codeql-query-suites
-  - /testing-custom-queries
-  - /creating-and-working-with-codeql-packs
-  - /publishing-and-using-codeql-packs
   - /sarif-output
   - /csv-output
   - /extractor-options
diff --git a/content/code-security/how-tos/scan-code-for-vulnerabilities/scan-from-the-command-line/index.md b/content/code-security/how-tos/scan-code-for-vulnerabilities/scan-from-the-command-line/index.md
@@ -17,4 +17,7 @@ children:
   - /testing-query-help-files
   - /specifying-command-options-in-a-codeql-configuration-file
   - /creating-database-bundle-for-troubleshooting
+redirect_from:
+  - /code-security/codeql-cli/using-the-codeql-cli
+  - /code-security/codeql-cli/getting-started-with-the-codeql-cli
 ---
diff --git a/content/code-security/tutorials/customize-code-scanning/analyzing-your-code-with-codeql-queries.md b/content/code-security/tutorials/customize-code-scanning/analyzing-your-code-with-codeql-queries.md
@@ -1,6 +1,6 @@
 ---
 title: Analyzing your code with CodeQL queries
-intro: 'You can run queries against a {% data variables.product.prodname_codeql %} database extracted from a codebase.'
+intro: You can run queries against a {% data variables.product.prodname_codeql %} database extracted from a codebase.
 product: '{% data reusables.gated-features.codeql %}'
 shortTitle: Analyzing code
 versions:
@@ -14,6 +14,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/analyzing-databases-with-the-codeql-cli
   - /code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli
+  - /code-security/codeql-cli/getting-started-with-the-codeql-cli/analyzing-your-code-with-codeql-queries
+contentType: tutorials
 ---
 
 ## About analyzing databases with the {% data variables.product.prodname_codeql_cli %}
diff --git a/content/code-security/tutorials/customize-code-scanning/creating-and-working-with-codeql-packs.md b/content/code-security/tutorials/customize-code-scanning/creating-and-working-with-codeql-packs.md
@@ -1,6 +1,6 @@
 ---
 title: Creating and working with CodeQL packs
-intro: 'You can use {% data variables.product.prodname_codeql %} packs to create, share, depend on, and run {% data variables.product.prodname_codeql %} queries and libraries.'
+intro: You can use {% data variables.product.prodname_codeql %} packs to create, share, depend on, and run {% data variables.product.prodname_codeql %} queries and libraries.
 product: '{% data reusables.gated-features.codeql %}'
 versions:
   fpt: '*'
@@ -13,6 +13,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/creating-and-working-with-codeql-packs
   - /code-security/codeql-cli/using-the-codeql-cli/creating-and-working-with-codeql-packs
+  - /code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/creating-and-working-with-codeql-packs
+contentType: tutorials
 ---
 
 ## About {% data variables.product.prodname_codeql %} packs and the {% data variables.product.prodname_codeql_cli %}
diff --git a/content/code-security/tutorials/customize-code-scanning/creating-codeql-query-suites.md b/content/code-security/tutorials/customize-code-scanning/creating-codeql-query-suites.md
@@ -1,6 +1,6 @@
 ---
 title: Creating CodeQL query suites
-intro: 'You can create query suites for queries you frequently use in your {% data variables.product.prodname_codeql %} analyses.'
+intro: You can create query suites for queries you frequently use in your {% data variables.product.prodname_codeql %} analyses.
 product: '{% data reusables.gated-features.codeql %}'
 versions:
   fpt: '*'
@@ -13,6 +13,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/creating-codeql-query-suites
   - /code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites
+  - /code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/creating-codeql-query-suites
+contentType: tutorials
 ---
 
 ## About creating {% data variables.product.prodname_codeql %} query suites
diff --git a/content/code-security/tutorials/customize-code-scanning/customizing-analysis-with-codeql-packs.md b/content/code-security/tutorials/customize-code-scanning/customizing-analysis-with-codeql-packs.md
@@ -1,6 +1,6 @@
 ---
 title: Customizing analysis with CodeQL packs
-intro: 'You can use {% data variables.product.prodname_codeql %} packs to run {% data variables.product.prodname_codeql %} queries maintained by other people, or to share {% data variables.product.prodname_codeql %} queries that you''ve developed.'
+intro: You can use {% data variables.product.prodname_codeql %} packs to run {% data variables.product.prodname_codeql %} queries maintained by other people, or to share {% data variables.product.prodname_codeql %} queries that you've developed.
 shortTitle: Customizing analysis
 product: '{% data reusables.gated-features.codeql %}'
 versions:
@@ -14,6 +14,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/about-codeql-packs
   - /code-security/codeql-cli/codeql-cli-reference/about-codeql-packs
+  - /code-security/codeql-cli/getting-started-with-the-codeql-cli/customizing-analysis-with-codeql-packs
+contentType: tutorials
 ---
 
 ## About {% data variables.product.prodname_codeql %} packs
diff --git a/content/code-security/tutorials/customize-code-scanning/index.md b/content/code-security/tutorials/customize-code-scanning/index.md
@@ -0,0 +1,23 @@
+---
+title: Customize code scanning
+intro: Learn how to customize code scanning to meet your project's unique security needs by creating and using CodeQL packs and custom queries.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+topics:
+  - Code Security
+  - Code scanning
+  - CodeQL
+contentType: tutorials
+children:
+  - /preparing-your-code-for-codeql-analysis
+  - /analyzing-your-code-with-codeql-queries
+  - /uploading-codeql-analysis-results-to-github
+  - /running-codeql-code-scanning-in-a-container
+  - /customizing-analysis-with-codeql-packs
+  - /creating-codeql-query-suites
+  - /testing-custom-queries
+  - /creating-and-working-with-codeql-packs
+  - /publishing-and-using-codeql-packs
+---
diff --git a/content/code-security/tutorials/customize-code-scanning/preparing-your-code-for-codeql-analysis.md b/content/code-security/tutorials/customize-code-scanning/preparing-your-code-for-codeql-analysis.md
@@ -1,6 +1,6 @@
 ---
 title: Preparing your code for CodeQL analysis
-intro: 'You can build a {% data variables.product.prodname_codeql %} database containing the data needed to analyze your code.'
+intro: You can build a {% data variables.product.prodname_codeql %} database containing the data needed to analyze your code.
 shortTitle: Preparing code for analysis
 permissions: '{% data reusables.permissions.repo-checkout %}'
 product: '{% data reusables.gated-features.codeql %}'
@@ -19,6 +19,8 @@ redirect_from:
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-code-scanning-in-your-ci-system
   - /code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system
+  - /code-security/codeql-cli/getting-started-with-the-codeql-cli/preparing-your-code-for-codeql-analysis
+contentType: tutorials
 ---
 <!--The CodeQL CLI man pages include a link to a section in this article. If you rename this article,
 make sure that you also update the MS short link: https://aka.ms/codeql-docs/indirect-tracing.-->
diff --git a/content/code-security/tutorials/customize-code-scanning/publishing-and-using-codeql-packs.md b/content/code-security/tutorials/customize-code-scanning/publishing-and-using-codeql-packs.md
@@ -1,6 +1,6 @@
 ---
 title: Publishing and using CodeQL packs
-intro: 'You can publish your own {% data variables.product.prodname_codeql %} packs and use packs published by other people.'
+intro: You can publish your own {% data variables.product.prodname_codeql %} packs and use packs published by other people.
 product: '{% data reusables.gated-features.codeql %}'
 versions:
   fpt: '*'
@@ -13,6 +13,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/publishing-and-using-codeql-packs
   - /code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs
+  - /code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/publishing-and-using-codeql-packs
+contentType: tutorials
 ---
 
 {% ifversion ghec or ghes %}
diff --git a/content/code-security/tutorials/customize-code-scanning/running-codeql-code-scanning-in-a-container.md b/content/code-security/tutorials/customize-code-scanning/running-codeql-code-scanning-in-a-container.md
@@ -1,14 +1,15 @@
 ---
 title: Running CodeQL code scanning in a container
 shortTitle: '{% data variables.product.prodname_code_scanning_caps %} in a container'
-intro: 'You can run {% data variables.product.prodname_code_scanning %} in a container by ensuring that all processes run in the same container.'
+intro: You can run {% data variables.product.prodname_code_scanning %} in a container by ensuring that all processes run in the same container.
 product: '{% data reusables.gated-features.code-scanning %}'
 redirect_from:
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-a-container
   - /code-security/secure-coding/running-codeql-code-scanning-in-a-container
   - /code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container
   - /code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container
+  - /code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/running-codeql-code-scanning-in-a-container
 versions:
   fpt: '*'
   ghes: '*'
@@ -22,6 +23,7 @@ topics:
   - Repositories
   - Containers
   - Java
+contentType: tutorials
 ---
 
 ## About {% data variables.product.prodname_code_scanning %} with a containerized build
diff --git a/content/code-security/tutorials/customize-code-scanning/testing-custom-queries.md b/content/code-security/tutorials/customize-code-scanning/testing-custom-queries.md
@@ -1,6 +1,6 @@
 ---
 title: Testing custom queries
-intro: 'You can set up tests for your {% data variables.product.prodname_codeql %} queries to ensure that they continue to return the expected results with new releases of the {% data variables.product.prodname_codeql_cli %}.'
+intro: You can set up tests for your {% data variables.product.prodname_codeql %} queries to ensure that they continue to return the expected results with new releases of the {% data variables.product.prodname_codeql_cli %}.
 product: '{% data reusables.gated-features.codeql %}'
 versions:
   fpt: '*'
@@ -13,6 +13,8 @@ topics:
 redirect_from:
   - /code-security/codeql-cli/testing-custom-queries
   - /code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries
+  - /code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/testing-custom-queries
+contentType: tutorials
 ---
 
 ## About testing custom queries
diff --git a/content/code-security/tutorials/customize-code-scanning/uploading-codeql-analysis-results-to-github.md b/content/code-security/tutorials/customize-code-scanning/uploading-codeql-analysis-results-to-github.md
@@ -1,7 +1,7 @@
 ---
 title: Uploading CodeQL analysis results to GitHub
 shortTitle: Uploading results to GitHub
-intro: 'You can use the {% data variables.product.prodname_codeql_cli %} to upload {% data variables.product.prodname_codeql %} analysis results to {% data variables.product.github %}.'
+intro: You can use the {% data variables.product.prodname_codeql_cli %} to upload {% data variables.product.prodname_codeql %} analysis results to {% data variables.product.github %}.
 permissions: '{% data reusables.permissions.code-scanning-all-alerts %}'
 product: '{% data reusables.gated-features.codeql %}'
 versions:
@@ -12,6 +12,9 @@ topics:
   - Code Security
   - Code scanning
   - CodeQL
+redirect_from:
+  - /code-security/codeql-cli/getting-started-with-the-codeql-cli/uploading-codeql-analysis-results-to-github
+contentType: tutorials
 ---
 
 ## About SARIF output
diff --git a/content/code-security/tutorials/index.md b/content/code-security/tutorials/index.md
@@ -16,13 +16,13 @@ topics:
   - Dependabot
 contentType: tutorials
 children:
-  - trialing-github-advanced-security
-  - adopting-github-advanced-security-at-scale
-  - secure-your-organization
-  - remediate-leaked-secrets
-  - secret-scanning-partner-program
-  - manage-security-alerts
-  - improve-code-quality
-  - fix-reported-vulnerabilities
+  - /secure-your-organization
+  - /remediate-leaked-secrets
+  - /customize-code-scanning
+  - /trialing-github-advanced-security
+  - /adopting-github-advanced-security-at-scale
+  - /secret-scanning-partner-program
+  - /manage-security-alerts
+  - /improve-code-quality
+  - /fix-reported-vulnerabilities
 ---
-
diff --git a/data/learning-tracks/code-security.yml b/data/learning-tracks/code-security.yml
@@ -194,7 +194,7 @@ code_security_actions:
     - >-
       /code-security/how-tos/scan-code-for-vulnerabilities/manage-your-configuration/codeql-code-scanning-for-compiled-languages
     - >-
-      /code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/running-codeql-code-scanning-in-a-container
+      /code-security/tutorials/customize-code-scanning/running-codeql-code-scanning-in-a-container
     - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors
     - >-
       /code-security/how-tos/scan-code-for-vulnerabilities/manage-your-configuration/about-the-tool-status-page
