github · docs-bot · Feb 24, 2026 · Feb 24, 2026 · Feb 24, 2026 · Feb 24, 2026
diff --git a/content/actions/reference/limits.md b/content/actions/reference/limits.md
@@ -42,6 +42,7 @@ These limits are subject to change.
 | Larger runners | Private IP scaling for vnet injection | 30% buffer | You need a buffer to accommodate the maximum job concurrency you anticipate. See [Private IP scaling for vnet injection on larger runners](#private-ip-scaling-for-vnet-injection-on-larger-runners). | {% octicon "check" aria-label="Yes" %} Configurable Azure virtual network |
 | Dependency caching | Uploads per minute | 200 per minute | Each repository is limited to 200 cache entry uploads per minute. If this limit is exceeded, subsequent cache upload attempts will fail until the rate limit resets. | {% octicon "x" aria-label="No" %} |
 | Dependency caching | Downloads per minute | 1500 per minute | Each repository is limited to 1500 cache entry downloads per minute. If this limit is exceeded, subsequent cache download attempts will fail until the rate limit resets. | {% octicon "x" aria-label="No" %} |
+| Dependency caching | Deletes per minute | 400 per minute | Each repository is limited to 400 cache delete operations per minute. If this limit is exceeded, subsequent cache delete attempts will fail until the rate limit resets. Each request to delete caches either by key or by ID counts towards this limit. | {% octicon "x" aria-label="No" %} |
 
 ### Job concurrency limits for {% data variables.product.github %}-hosted runners
 

diff --git a/content/code-security/how-tos/scan-code-for-vulnerabilities/index.md b/content/code-security/how-tos/scan-code-for-vulnerabilities/index.md
@@ -14,5 +14,5 @@ children:
   - /scan-from-the-command-line
   - /scan-from-vs-code
   - /integrate-with-existing-tools
-  - /troubleshooting
 ---
+
diff --git a/...nt/code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/index.md b/...nt/code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/index.md
diff --git a/...for-vulnerabilities/troubleshooting/troubleshooting-codeql-for-vs-code/index.md b/...for-vulnerabilities/troubleshooting/troubleshooting-codeql-for-vs-code/index.md
diff --git a/content/code-security/how-tos/secure-at-scale/index.md b/content/code-security/how-tos/secure-at-scale/index.md
@@ -15,7 +15,7 @@ topics:
   - Dependabot
 contentType: how-tos
 children:
-   - /configure-enterprise-security
-   - /configure-organization-security
-   - /troubleshoot-security-configurations
+  - /configure-enterprise-security
+  - /configure-organization-security
 ---
+
diff --git a/content/code-security/how-tos/secure-your-supply-chain/index.md b/content/code-security/how-tos/secure-your-supply-chain/index.md
@@ -16,6 +16,5 @@ redirect_from:
 children:
   - secure-your-dependencies
   - manage-your-dependency-security
-  - troubleshoot-dependency-security
   - establish-provenance-and-integrity
 ---
diff --git a/...rity/how-tos/secure-your-supply-chain/troubleshoot-dependency-security/index.md b/...rity/how-tos/secure-your-supply-chain/troubleshoot-dependency-security/index.md
diff --git a/...ting-codeql-for-vs-code/accessing-logs.md → ...deql/codeql-for-vs-code/accessing-logs.md b/...ting-codeql-for-vs-code/accessing-logs.md → ...deql/codeql-for-vs-code/accessing-logs.md
@@ -13,7 +13,8 @@ intro: If you need to troubleshoot problems with {% data variables.product.prodn
 allowTitleToDifferFromFilename: true
 redirect_from:
   - /code-security/codeql-for-vs-code/troubleshooting-codeql-for-vs-code/accessing-logs
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-codeql-for-vs-code/accessing-logs
+contentType: reference
 ---
 
 ## About logs

diff --git a/content/code-security/reference/code-scanning/codeql/codeql-for-vs-code/index.md b/content/code-security/reference/code-scanning/codeql/codeql-for-vs-code/index.md
@@ -0,0 +1,23 @@
+---
+title: CodeQL for Visual Studio Code reference
+shortTitle: CodeQL for VS Code
+intro: Find troubleshooting and telemetry information for the {% data variables.product.prodname_codeql %} extension for {% data variables.product.prodname_vscode_shortname %}.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+topics:
+  - Code Security
+  - Code scanning
+  - Vulnerabilities
+  - CodeQL
+contentType: reference
+children:
+  - /telemetry-in-codeql-for-visual-studio-code
+  - /accessing-logs
+  - /warning-problem-with-controller-repository
+redirect_from:
+  - /code-security/codeql-for-vs-code/troubleshooting-codeql-for-visual-studio-code
+  - /code-security/codeql-for-vs-code/troubleshooting-codeql-for-vs-code
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-codeql-for-vs-code
+---
diff --git a/...metry-in-codeql-for-visual-studio-code.md → ...metry-in-codeql-for-visual-studio-code.md b/...metry-in-codeql-for-visual-studio-code.md → ...metry-in-codeql-for-visual-studio-code.md
@@ -14,6 +14,7 @@ intro: If {% data variables.product.prodname_vscode_shortname %} telemetry is en
 redirect_from:
   - /code-security/codeql-for-vs-code/about-telemetry-in-codeql-for-visual-studio-code
   - /code-security/codeql-for-vs-code/using-the-advanced-functionality-of-the-codeql-for-vs-code-extension/telemetry-in-codeql-for-visual-studio-code
+  - /code-security/reference/code-scanning/codeql/telemetry-in-codeql-for-visual-studio-code
 contentType: reference
 ---
 

diff --git a/...ing-problem-with-controller-repository.md → ...ing-problem-with-controller-repository.md b/...ing-problem-with-controller-repository.md → ...ing-problem-with-controller-repository.md
@@ -1,5 +1,6 @@
 ---
 title: Problem with controller repository
+shortTitle: Troubleshoot controller repository
 versions:
   feature: codeql-vs-code-mrva
 topics:
@@ -11,7 +12,8 @@ allowTitleToDifferFromFilename: true
 redirect_from:
   - /code-security/codeql-for-vs-code/troubleshooting-variant-analysis
   - /code-security/codeql-for-vs-code/troubleshooting-codeql-for-vs-code/warning-problem-with-controller-repository
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-codeql-for-vs-code/warning-problem-with-controller-repository
+contentType: reference
 ---
 
 ## About this warning

diff --git a/content/code-security/reference/code-scanning/codeql/index.md b/content/code-security/reference/code-scanning/codeql/index.md
@@ -13,8 +13,8 @@ topics:
 contentType: reference
 children:
   - /recommended-hardware-resources-for-running-codeql
-  - /telemetry-in-codeql-for-visual-studio-code
   - /codeql-queries
   - /codeql-cli
   - /codeql-cli-manual
+  - /codeql-for-vs-code
 ---
diff --git a/content/code-security/reference/code-scanning/index.md b/content/code-security/reference/code-scanning/index.md
@@ -14,6 +14,7 @@ contentType: reference
 redirect_from:
   - /code-security/code-scanning/reference
 children:
-  - sarif-support-for-code-scanning
+  - sarif-files
   - codeql
+  - troubleshoot-analysis-errors
 ---
diff --git a/content/code-security/reference/code-scanning/sarif-files/index.md b/content/code-security/reference/code-scanning/sarif-files/index.md
@@ -0,0 +1,18 @@
+---
+title: Reference for SARIF files for code scanning
+shortTitle: SARIF files
+intro: Learn about and troubleshoot SARIF support for {% data variables.product.prodname_code_scanning %}.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+contentType: reference
+topics:
+  - Code scanning
+  - Errors
+  - Troubleshooting
+  - SARIF
+children:
+  - /sarif-support-for-code-scanning
+  - /troubleshoot-sarif-uploads
+---
diff --git a/...anning/sarif-support-for-code-scanning.md → ...-files/sarif-support-for-code-scanning.md b/...anning/sarif-support-for-code-scanning.md → ...-files/sarif-support-for-code-scanning.md
@@ -10,6 +10,7 @@ redirect_from:
   - /code-security/secure-coding/integrating-with-code-scanning/sarif-support-for-code-scanning
   - /github/finding-security-vulnerabilities-and-errors-in-your-code/integrating-with-code-scanning/sarif-support-for-code-scanning
   - /code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning
+  - /code-security/reference/code-scanning/sarif-support-for-code-scanning
 versions:
   fpt: '*'
   ghes: '*'

diff --git a/...ng-sarif-uploads/default-setup-enabled.md → ...ot-sarif-uploads/default-setup-enabled.md b/...ng-sarif-uploads/default-setup-enabled.md → ...ot-sarif-uploads/default-setup-enabled.md
@@ -15,7 +15,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-sarif/default-setup-enabled
   - /code-security/code-scanning/troubleshooting-sarif-uploads/default-setup-enabled
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-sarif-uploads/default-setup-enabled
+contentType: reference
 ---
 
 ## About this error

diff --git a/...eshooting-sarif-uploads/file-too-large.md → ...ubleshoot-sarif-uploads/file-too-large.md b/...eshooting-sarif-uploads/file-too-large.md → ...ubleshoot-sarif-uploads/file-too-large.md
@@ -15,7 +15,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-sarif/file-too-large
   - /code-security/code-scanning/troubleshooting-sarif-uploads/file-too-large
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-sarif-uploads/file-too-large
+contentType: reference
 ---
 
 ## About this error

diff --git a/...leshooting-sarif-uploads/ghas-required.md → ...oubleshoot-sarif-uploads/ghas-required.md b/...leshooting-sarif-uploads/ghas-required.md → ...oubleshoot-sarif-uploads/ghas-required.md
@@ -15,7 +15,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-sarif/ghas-required
   - /code-security/code-scanning/troubleshooting-sarif-uploads/ghas-required
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-sarif-uploads/ghas-required
+contentType: reference
 ---
 
 ## About this error

diff --git a/...ng/troubleshooting-sarif-uploads/index.md → ...files/troubleshoot-sarif-uploads/index.md b/...ng/troubleshooting-sarif-uploads/index.md → ...files/troubleshoot-sarif-uploads/index.md
@@ -6,7 +6,7 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-contentType: how-tos
+contentType: reference
 topics:
   - Code scanning
   - Errors
@@ -19,4 +19,8 @@ children:
   - /file-too-large
   - /ghas-required
   - /default-setup-enabled
+redirect_from:
+  - /code-security/code-scanning/troubleshooting-sarif
+  - /code-security/code-scanning/troubleshooting-sarif-uploads
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-sarif-uploads
 ---
diff --git a/...leshooting-sarif-uploads/missing-token.md → ...oubleshoot-sarif-uploads/missing-token.md b/...leshooting-sarif-uploads/missing-token.md → ...oubleshoot-sarif-uploads/missing-token.md
@@ -15,7 +15,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-sarif/missing-token
   - /code-security/code-scanning/troubleshooting-sarif-uploads/missing-token
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-sarif-uploads/missing-token
+contentType: reference
 ---
 
 ## About this error

diff --git a/...ing-sarif-uploads/results-exceed-limit.md → ...oot-sarif-uploads/results-exceed-limit.md b/...ing-sarif-uploads/results-exceed-limit.md → ...oot-sarif-uploads/results-exceed-limit.md
@@ -15,7 +15,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-sarif/results-exceed-limit
   - /code-security/code-scanning/troubleshooting-sarif-uploads/results-exceed-limit
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-sarif-uploads/results-exceed-limit
+contentType: reference
 ---
 
 ## About {% data variables.product.prodname_code_scanning %} limits on SARIF results

diff --git a/...leshooting-sarif-uploads/sarif-invalid.md → ...oubleshoot-sarif-uploads/sarif-invalid.md b/...leshooting-sarif-uploads/sarif-invalid.md → ...oubleshoot-sarif-uploads/sarif-invalid.md
@@ -15,7 +15,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-sarif/sarif-invalid
   - /code-security/code-scanning/troubleshooting-sarif-uploads/sarif-invalid
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-sarif-uploads/sarif-invalid
+contentType: reference
 ---
 
 ## About this error

diff --git a/...rors/advanced-security-must-be-enabled.md → ...rors/advanced-security-must-be-enabled.md b/...rors/advanced-security-must-be-enabled.md → ...rors/advanced-security-must-be-enabled.md
@@ -13,7 +13,8 @@ versions:
   ghec: '*'
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/advanced-security-must-be-enabled
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/advanced-security-must-be-enabled
+contentType: reference
 ---
 
 ## About this error

diff --git a/...alysis-errors/alerts-in-generated-code.md → ...alysis-errors/alerts-in-generated-code.md b/...alysis-errors/alerts-in-generated-code.md → ...alysis-errors/alerts-in-generated-code.md
@@ -10,7 +10,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/alerts-found-in-generated-code
   - /code-security/code-scanning/troubleshooting-code-scanning/alerts-in-generated-code
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/alerts-in-generated-code
+contentType: reference
 ---
 
 {% data reusables.code-scanning.codeql-action-version-ghes %}

diff --git a/...nalysis-errors/analysis-takes-too-long.md → ...nalysis-errors/analysis-takes-too-long.md b/...nalysis-errors/analysis-takes-too-long.md → ...nalysis-errors/analysis-takes-too-long.md
@@ -10,7 +10,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/build-is-taking-too-long
   - /code-security/code-scanning/troubleshooting-code-scanning/analysis-takes-too-long
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/analysis-takes-too-long
+contentType: reference
 ---
 
 {% data reusables.code-scanning.codeql-action-version-ghes %}

diff --git a/...analysis-errors/automatic-build-failed.md → ...analysis-errors/automatic-build-failed.md b/...analysis-errors/automatic-build-failed.md → ...analysis-errors/automatic-build-failed.md
@@ -10,7 +10,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/automatic-build-failed-for-a-compiled-language
   - /code-security/code-scanning/troubleshooting-code-scanning/automatic-build-failed
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/automatic-build-failed
+contentType: reference
 ---
 
 {% data reusables.code-scanning.codeql-action-version-ghes %}

diff --git a/.../c-sharp-compiler-unexpectedly-failing.md → .../c-sharp-compiler-unexpectedly-failing.md b/.../c-sharp-compiler-unexpectedly-failing.md → .../c-sharp-compiler-unexpectedly-failing.md
@@ -9,7 +9,8 @@ versions:
   ghec: '*'
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/c-sharp-compiler-unexpectedly-failing
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/c-sharp-compiler-unexpectedly-failing
+contentType: reference
 ---
 
 ## About these errors

diff --git a/...-enable-codeql-in-a-private-repository.md → ...-enable-codeql-in-a-private-repository.md b/...-enable-codeql-in-a-private-repository.md → ...-enable-codeql-in-a-private-repository.md
@@ -12,7 +12,8 @@ versions:
   ghec: '*'
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/cannot-enable-codeql-in-a-private-repository
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/cannot-enable-codeql-in-a-private-repository
+contentType: reference
 ---
 
 {% ifversion fpt %}

diff --git a/.../enabling-default-setup-takes-too-long.md → .../enabling-default-setup-takes-too-long.md b/.../enabling-default-setup-takes-too-long.md → .../enabling-default-setup-takes-too-long.md
@@ -8,7 +8,8 @@ versions:
   ghec: '*'
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/enabling-default-setup-takes-too-long
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/enabling-default-setup-takes-too-long
+contentType: reference
 ---
 
 

diff --git a/...rors/extraction-errors-in-the-database.md → ...rors/extraction-errors-in-the-database.md b/...rors/extraction-errors-in-the-database.md → ...rors/extraction-errors-in-the-database.md
@@ -8,7 +8,8 @@ versions:
   ghec: '*'
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/extraction-errors-in-the-database
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/extraction-errors-in-the-database
+contentType: reference
 ---
 
 {% data reusables.code-scanning.codeql-action-version-ghes %}

diff --git a/...rors/fewer-lines-scanned-than-expected.md → ...rors/fewer-lines-scanned-than-expected.md b/...rors/fewer-lines-scanned-than-expected.md → ...rors/fewer-lines-scanned-than-expected.md
@@ -10,7 +10,8 @@ versions:
 redirect_from:
   - /code-security/code-scanning/troubleshooting-code-scanning/codeql-scanned-fewer-lines-than-expected
   - /code-security/code-scanning/troubleshooting-code-scanning/fewer-lines-scanned-than-expected
-contentType: how-tos
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors/fewer-lines-scanned-than-expected
+contentType: reference
 ---
 
 ## About analysis of compiled languages

diff --git a/.../troubleshooting-analysis-errors/index.md → ...ing/troubleshoot-analysis-errors/index.md b/.../troubleshooting-analysis-errors/index.md → ...ing/troubleshoot-analysis-errors/index.md
@@ -1,12 +1,12 @@
 ---
-title: Troubleshooting analysis errors
+title: Troubleshooting code scanning analysis errors
 shortTitle: Troubleshoot analysis errors
 intro: Identify and resolve errors that occur during code analysis, including build failures, incomplete scans, resource limits, and unexpected results.
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-contentType: how-tos
+contentType: reference
 topics:
   - Code scanning
   - Errors
@@ -38,4 +38,6 @@ redirect_from:
   - /code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow
   - /code-security/code-scanning/troubleshooting-code-scanning/results-differ-between-platforms
   - /code-security/code-scanning/troubleshooting-code-scanning
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting/troubleshooting-analysis-errors
+  - /code-security/how-tos/scan-code-for-vulnerabilities/troubleshooting
 ---