[EDI] Create a new "Secret security" map topic within "Concepts" (#59053)

sophietheking · mchammer01 · web-flow · commit 810ec0a4b390 · 2026-01-09T15:45:55.000Z
Co-authored-by: mc &lt;42146119+mchammer01@users.noreply.github.com&gt;
diff --git a/content/code-security/concepts/index.md b/content/code-security/concepts/index.md
@@ -16,6 +16,7 @@ topics:
   - Dependabot
 contentType: concepts
 children:
+  - /secret-security
   - /code-scanning
   - /about-code-quality
   - supply-chain-security
diff --git a/content/code-security/concepts/secret-security/about-alerts.md b/content/code-security/concepts/secret-security/about-alerts.md
@@ -1,6 +1,6 @@
 ---
 title: About secret scanning alerts
-intro: 'Learn about the different types of {% data variables.secret-scanning.alerts %}.'
+intro: Learn about the different types of {% data variables.secret-scanning.alerts %}.
 permissions: '{% data reusables.permissions.secret-scanning-alerts %}'
 product: '{% data reusables.gated-features.secret-scanning %}'
 versions:
@@ -13,8 +13,11 @@ topics:
   - Secret Protection
   - Alerts
   - Repositories
-shortTitle: About alerts
+shortTitle: Secret scanning alerts
 allowTitleToDifferFromFilename: true
+redirect_from:
+  - /code-security/secret-scanning/managing-alerts-from-secret-scanning/about-alerts
+contentType: concepts
 ---
 
 ## About types of alerts
diff --git a/content/code-security/concepts/secret-security/about-delegated-bypass-for-push-protection.md b/content/code-security/concepts/secret-security/about-delegated-bypass-for-push-protection.md
@@ -12,7 +12,10 @@ topics:
   - Secret Protection
   - Alerts
   - Repositories
-shortTitle: About delegated bypass
+shortTitle: Delegated bypass
+redirect_from:
+  - /code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/delegated-bypass-for-push-protection/about-delegated-bypass-for-push-protection
+contentType: concepts
 ---
 
 ## About delegated bypass for push protection
diff --git a/content/code-security/concepts/secret-security/about-push-protection.md b/content/code-security/concepts/secret-security/about-push-protection.md
@@ -1,6 +1,6 @@
 ---
 title: About push protection
-intro: 'Push protection blocks contributors from pushing secrets to a repository and generates an alert whenever a contributor bypasses the block.{% ifversion secret-scanning-push-protection-for-users %} Push protection can be applied at the repository, organization, and user account level{% else %} You can apply push protection at repository or organization level{% endif %}.'
+intro: Push protection blocks contributors from pushing secrets to a repository and generates an alert whenever a contributor bypasses the block.{% ifversion secret-scanning-push-protection-for-users %} Push protection can be applied at the repository, organization, and user account level{% else %} You can apply push protection at repository or organization level{% endif %}.
 product: '{% data reusables.gated-features.push-protection-for-repos %}'
 versions:
   fpt: '*'
@@ -10,13 +10,15 @@ redirect_from:
   - /early-access/code-security/secret-scanning/protecting-pushes-with-secret-scanning
   - /code-security/secret-scanning/protecting-pushes-with-secret-scanning
   - /code-security/secret-scanning/push-protection-for-repositories-and-organizations
+  - /code-security/secret-scanning/introduction/about-push-protection
 type: overview
 topics:
   - Secret scanning
   - Secret Protection
   - Alerts
   - Repositories
 shortTitle: Push protection
+contentType: concepts
 ---
 
 ## About push protection
diff --git a/content/code-security/concepts/secret-security/about-secret-scanning-for-partners.md b/content/code-security/concepts/secret-security/about-secret-scanning-for-partners.md
@@ -1,6 +1,6 @@
 ---
 title: About secret scanning for partners
-intro: 'When {% data variables.product.prodname_secret_scanning %} detects authentication details for a service provider in a public repository on {% data variables.product.prodname_dotcom %}, an alert is sent directly to the provider. This allows service providers who are {% data variables.product.prodname_dotcom %} partners to promptly take action to secure their systems.'
+intro: When {% data variables.product.prodname_secret_scanning %} detects authentication details for a service provider in a public repository on {% data variables.product.prodname_dotcom %}, an alert is sent directly to the provider. This allows service providers who are {% data variables.product.prodname_dotcom %} partners to promptly take action to secure their systems.
 product: '{% data reusables.gated-features.secret-scanning-partner-alerts %}'
 versions:
   fpt: '*'
@@ -10,6 +10,9 @@ topics:
   - Secret scanning
   - Secret Protection
 shortTitle: Secret scanning for partners
+redirect_from:
+  - /code-security/secret-scanning/introduction/about-secret-scanning-for-partners
+contentType: concepts
 ---
 
 ## About {% data variables.secret-scanning.partner_alerts %}
diff --git a/content/code-security/concepts/secret-security/about-secret-scanning.md b/content/code-security/concepts/secret-security/about-secret-scanning.md
@@ -12,6 +12,7 @@ redirect_from:
   - /github/administering-a-repository/about-secret-scanning
   - /code-security/secret-security/about-secret-scanning
   - /code-security/secret-scanning/about-secret-scanning
+  - /code-security/secret-scanning/introduction/about-secret-scanning
 versions:
   fpt: '*'
   ghes: '*'
@@ -21,6 +22,7 @@ topics:
   - Secret scanning
   - Secret Protection
 shortTitle: Secret scanning
+contentType: concepts
 ---
 
 ## About {% data variables.product.prodname_secret_scanning %}
diff --git a/content/code-security/concepts/secret-security/about-secret-security-with-github.md b/content/code-security/concepts/secret-security/about-secret-security-with-github.md
@@ -1,9 +1,9 @@
 ---
-title: 'About secret security with GitHub'
-shortTitle: 'Secret protection tools'
-intro: 'Learn how {% data variables.product.github %}''s security tools can help you identify, remediate, and prevent secret leaks.'
+title: About secret security with GitHub
+shortTitle: Secret protection tools
+intro: Learn how {% data variables.product.github %}'s security tools can help you identify, remediate, and prevent secret leaks.
 product: '{% data reusables.gated-features.secret-protection %}'
-permissions: 'Organizations on {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %}'
+permissions: Organizations on {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %}
 contentType: concepts
 versions:
   feature: secret-risk-assessment
@@ -15,6 +15,7 @@ topics:
   - Security
 redirect_from:
   - /code-security/securing-your-organization/understanding-your-organizations-exposure-to-leaked-secrets/about-secret-risk-assessment
+  - /code-security/securing-your-organization/understanding-your-organizations-exposure-to-leaked-secrets/about-secret-security-with-github
 ---
 
 {% data variables.product.github %} provides tools to help you understand and address your organization's exposure to leaked secrets:
diff --git a/content/code-security/concepts/secret-security/index.md b/content/code-security/concepts/secret-security/index.md
@@ -0,0 +1,22 @@
+---
+title: Concepts for secret security
+shortTitle: Secret security
+intro: Learn core concepts for {% data variables.product.github %}'s secret security features.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+topics:
+  - Secret Protection
+  - Secret scanning
+contentType: concepts
+children:
+  - /about-secret-scanning
+  - /about-push-protection
+  - /about-secret-security-with-github
+  - /about-alerts
+  - /about-delegated-bypass-for-push-protection
+  - /about-secret-scanning-for-partners
+  - /working-with-push-protection-and-the-github-mcp-server
+  - /working-with-push-protection-from-the-rest-api
+---
diff --git a/content/code-security/concepts/secret-security/working-with-push-protection-and-the-github-mcp-server.md b/content/code-security/concepts/secret-security/working-with-push-protection-and-the-github-mcp-server.md
@@ -1,8 +1,8 @@
 ---
 title: Working with push protection and the GitHub MCP server
 shortTitle: Push protection and the GitHub MCP server
-intro: 'Learn how you are protected from leaking secrets during interactions with the {% data variables.product.github %} MCP server, and how to bypass a push protection block if you need to.'
-product: 'Public repositories on {% data variables.product.prodname_dotcom_the_website %}'
+intro: Learn how you are protected from leaking secrets during interactions with the {% data variables.product.github %} MCP server, and how to bypass a push protection block if you need to.
+product: Public repositories on {% data variables.product.prodname_dotcom_the_website %}
 permissions: '{% data reusables.permissions.push-protection-resolve-block %}'
 versions:
   feature: copilot
@@ -13,6 +13,9 @@ topics:
   - Alerts
   - Repositories
   - Copilot
+redirect_from:
+  - /code-security/secret-scanning/working-with-secret-scanning-and-push-protection/working-with-push-protection-and-the-github-mcp-server
+contentType: concepts
 ---
 
 ## About push protection and the {% data variables.product.github %} MCP server
diff --git a/content/code-security/concepts/secret-security/working-with-push-protection-from-the-rest-api.md b/content/code-security/concepts/secret-security/working-with-push-protection-from-the-rest-api.md
@@ -1,7 +1,7 @@
 ---
 title: Working with push protection from the REST API
 shortTitle: Push protection from the REST API
-intro: 'Learn your options for unblocking your push to {% data variables.product.prodname_dotcom %} using the REST API if {% data variables.product.prodname_secret_scanning %} detects a secret in the content of your API request.'
+intro: Learn your options for unblocking your push to {% data variables.product.prodname_dotcom %} using the REST API if {% data variables.product.prodname_secret_scanning %} detects a secret in the content of your API request.
 permissions: '{% data reusables.permissions.push-protection-resolve-block %}'
 versions:
   feature: secret-scanning-push-protection-content-endpoints
@@ -11,6 +11,9 @@ topics:
   - Secret Protection
   - Alerts
   - Repositories
+redirect_from:
+  - /code-security/secret-scanning/working-with-secret-scanning-and-push-protection/working-with-push-protection-from-the-rest-api
+contentType: concepts
 ---
 
 ## About push protection from the REST API
diff --git a/content/code-security/secret-scanning/introduction/index.md b/content/code-security/secret-scanning/introduction/index.md
@@ -2,7 +2,7 @@
 title: Introduction to secret scanning
 shortTitle: Introduction
 allowTitleToDifferFromFilename: true
-intro: 'Learn how {% data variables.product.prodname_secret_scanning %} detects secrets in existing content and new commits, helping you to avoid exposing sensitive data that could be exploited.'
+intro: Learn how {% data variables.product.prodname_secret_scanning %} detects secrets in existing content and new commits, helping you to avoid exposing sensitive data that could be exploited.
 product: '{% data reusables.gated-features.secret-scanning %}'
 versions:
   fpt: '*'
@@ -13,8 +13,6 @@ topics:
   - Secret scanning
   - Secret Protection
 children:
-  - /about-secret-scanning
-  - /about-push-protection
-  - /about-secret-scanning-for-partners
   - /supported-secret-scanning-patterns
 ---
+
diff --git a/content/code-security/secret-scanning/managing-alerts-from-secret-scanning/index.md b/content/code-security/secret-scanning/managing-alerts-from-secret-scanning/index.md
@@ -1,11 +1,10 @@
 ---
 title: Managing alerts from secret scanning
-intro: 'Learn how to find, evaluate, and resolve alerts for secrets stored in your repository.'
+intro: Learn how to find, evaluate, and resolve alerts for secrets stored in your repository.
 product: '{% data reusables.gated-features.secret-scanning %}'
 redirect_from:
   - /github/administering-a-repository/managing-alerts-from-secret-scanning
   - /code-security/secret-security/managing-alerts-from-secret-scanning
-
 versions:
   fpt: '*'
   ghes: '*'
@@ -18,9 +17,9 @@ topics:
   - Repositories
 shortTitle: Manage alerts
 children:
-  - /about-alerts
   - /viewing-alerts
   - /evaluating-alerts
   - /resolving-alerts
   - /monitoring-alerts
 ---
+
diff --git a/content/code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/delegated-bypass-for-push-protection/index.md b/content/code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/delegated-bypass-for-push-protection/index.md
@@ -2,7 +2,7 @@
 title: Delegated bypass for push protection
 shortTitle: Delegated bypass
 allowTitleToDifferFromFilename: true
-intro: 'You can control the ability to bypass push protection by setting up a reviewers group to assess requests. When a contributor proposes bypassing protections, any member of the bypass list can approve or block the request.'
+intro: You can control the ability to bypass push protection by setting up a reviewers group to assess requests. When a contributor proposes bypassing protections, any member of the bypass list can approve or block the request.
 product: '{% data reusables.gated-features.secret-scanning %}'
 versions:
   feature: push-protection-delegated-bypass
@@ -11,7 +11,7 @@ topics:
   - Secret Protection
   - Repositories
 children:
-  - /about-delegated-bypass-for-push-protection
   - /enabling-delegated-bypass-for-push-protection
   - /managing-requests-to-bypass-push-protection
 ---
+
diff --git a/content/code-security/secret-scanning/working-with-secret-scanning-and-push-protection/index.md b/content/code-security/secret-scanning/working-with-secret-scanning-and-push-protection/index.md
@@ -2,7 +2,7 @@
 title: Working with secret scanning and push protection
 shortTitle: Work with secret scanning
 allowTitleToDifferFromFilename: true
-intro: 'Avoid leaking sensitive data by blocking pushes containing tokens and other secrets.'
+intro: Avoid leaking sensitive data by blocking pushes containing tokens and other secrets.
 product: '{% data reusables.gated-features.secret-scanning %}'
 versions:
   fpt: '*'
@@ -16,10 +16,9 @@ children:
   - /remediating-a-leaked-secret
   - /push-protection-for-users
   - /working-with-push-protection-from-the-command-line
-  - /working-with-push-protection-from-the-rest-api
   - /working-with-push-protection-in-the-github-ui
-  - /working-with-push-protection-and-the-github-mcp-server
 redirect_from:
   - /code-security/secret-scanning/working-with-push-protection
   - /code-security/secret-scanning/pushing-a-branch-blocked-by-push-protection
 ---
+
diff --git a/content/code-security/securing-your-organization/understanding-your-organizations-exposure-to-leaked-secrets/index.md b/content/code-security/securing-your-organization/understanding-your-organizations-exposure-to-leaked-secrets/index.md
@@ -11,7 +11,6 @@ topics:
   - Code Security
   - Security
 children:
-  - /about-secret-security-with-github
   - /assess-your-secret-risk
   - /viewing-the-secret-risk-assessment-report-for-your-organization
   - /export-risk-report-csv
diff --git a/data/learning-tracks/code-security.yml b/data/learning-tracks/code-security.yml
@@ -111,7 +111,7 @@ secret_scanning:
     Set up secret scanning to guard against accidental check-ins of tokens,
     passwords, and other secrets to your repository.
   guides:
-    - /code-security/secret-scanning/introduction/about-secret-scanning
+    - /code-security/concepts/secret-security/about-secret-scanning
     - /code-security/secret-scanning/enabling-secret-scanning-features/enabling-secret-scanning-for-your-repository
     - /code-security/secret-scanning/enabling-secret-scanning-features/enabling-push-protection-for-your-repository
     - >-
@@ -125,7 +125,7 @@ secret_scanning:
     - /code-security/secret-scanning/introduction/supported-secret-scanning-patterns
     - >-
       {% ifversion secret-scanning-push-protection
-      %}/code-security/secret-scanning/introduction/about-push-protection{%
+      %}/code-security/concepts/secret-security/about-push-protection{%
       endif %}
     - >-
       {% ifversion secret-scanning-push-protection-for-users
