[EDI] Create "Concepts" category in the GitHub Actions docset (#56295)

subatoi · Copilot · lecoursen · web-flow · commit 4a7cf8e2eb1a · 2025-06-25T13:16:05.000Z
Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;
Co-authored-by: Laura Coursen &lt;lecoursen@github.com&gt;
diff --git a/content/actions/about-github-actions/index.md b/content/actions/about-github-actions/index.md
@@ -8,7 +8,5 @@ versions:
   ghec: '*'
 children:
   - /understanding-github-actions
-  - /about-continuous-integration-with-github-actions
-  - /about-continuous-deployment-with-github-actions
 ---
 
diff --git a/content/actions/administering-github-actions/index.md b/content/actions/administering-github-actions/index.md
@@ -7,7 +7,6 @@ versions:
   ghes: '*'
   ghec: '*'
 children:
-  - /usage-limits-billing-and-administration
   - /viewing-github-actions-metrics
   - /sharing-workflows-secrets-and-runners-with-your-organization
   - /making-retired-namespaces-available-on-ghecom
diff --git a/content/actions/concepts/index.md b/content/actions/concepts/index.md
@@ -0,0 +1,14 @@
+---
+title: Concepts
+intro: "Learn the core concepts that you'll need to understand GitHub Actions."
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /overview
+  - /workflows-and-actions
+  - /runners
+  - /security
+  - /use-cases
+---
diff --git a/content/actions/concepts/overview/about-continuous-deployment-with-github-actions.md b/content/actions/concepts/overview/about-continuous-deployment-with-github-actions.md
@@ -12,6 +12,7 @@ redirect_from:
   - /actions/deployment/about-deployments/about-continuous-deployment
   - /actions/deployment/about-deployments
   - /actions/about-github-actions/about-continuous-deployment
+  - /actions/about-github-actions/about-continuous-deployment-with-github-actions
 topics:
   - CD
 ---
diff --git a/content/actions/concepts/overview/about-continuous-integration-with-github-actions.md b/content/actions/concepts/overview/about-continuous-integration-with-github-actions.md
@@ -9,6 +9,7 @@ redirect_from:
   - /actions/guides/about-continuous-integration
   - /actions/automating-builds-and-tests/about-continuous-integration
   - /actions/about-github-actions/about-continuous-integration
+  - /actions/about-github-actions/about-continuous-integration-with-github-actions
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/concepts/overview/index.md b/content/actions/concepts/overview/index.md
@@ -0,0 +1,13 @@
+---
+title: Overview of GitHub Actions
+shortTitle: Overview
+intro: "Learn the overarching concepts that apply to GitHub Actions as a whole."
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /about-continuous-deployment-with-github-actions
+  - /about-continuous-integration-with-github-actions
+  - /usage-limits-billing-and-administration
+---
diff --git a/content/actions/concepts/overview/usage-limits-billing-and-administration.md b/content/actions/concepts/overview/usage-limits-billing-and-administration.md
@@ -5,6 +5,7 @@ redirect_from:
   - /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions
   - /actions/reference/usage-limits-billing-and-administration
   - /actions/learn-github-actions/usage-limits-billing-and-administration
+  - /actions/administering-github-actions/usage-limits-billing-and-administration
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/concepts/runners/about-actions-runner-controller.md b/content/actions/concepts/runners/about-actions-runner-controller.md
@@ -10,6 +10,8 @@ versions:
 type: overview
 topics:
   - Actions Runner Controller
+redirect_from:
+  - /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller
 ---
 
 [Legal notice](#legal-notice)
diff --git a/content/actions/concepts/runners/about-larger-runners.md b/content/actions/concepts/runners/about-larger-runners.md
@@ -7,6 +7,7 @@ versions:
   feature: actions-hosted-runners
 redirect_from:
   - /actions/using-github-hosted-runners/about-larger-runners/about-larger-runners
+  - /actions/using-github-hosted-runners/using-larger-runners/about-larger-runners
 ---
 
 ## Overview of {% data variables.actions.hosted_runners %}
diff --git a/content/actions/concepts/runners/about-private-networking-with-github-hosted-runners.md b/content/actions/concepts/runners/about-private-networking-with-github-hosted-runners.md
@@ -15,6 +15,8 @@ topics:
   - Developer
   - CI
   - CD
+redirect_from:
+  - /actions/using-github-hosted-runners/connecting-to-a-private-network/about-private-networking-with-github-hosted-runners
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/runners/about-self-hosted-runners.md b/content/actions/concepts/runners/about-self-hosted-runners.md
@@ -5,6 +5,7 @@ redirect_from:
   - /github/automating-your-workflow-with-github-actions/about-self-hosted-runners
   - /actions/automating-your-workflow-with-github-actions/about-self-hosted-runners
   - /actions/hosting-your-own-runners/about-self-hosted-runners
+  - /actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/concepts/runners/about-support-for-actions-runner-controller.md b/content/actions/concepts/runners/about-support-for-actions-runner-controller.md
@@ -9,6 +9,8 @@ versions:
 topics:
   - Actions Runner Controller
   - Support
+redirect_from:
+  - /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-support-for-actions-runner-controller
 ---
 
 You can [contact {% data variables.contact.github_support %}](/support/contacting-github-support) for assistance with Actions Runner Controller.
diff --git a/content/actions/concepts/runners/communicating-with-self-hosted-runners.md b/content/actions/concepts/runners/communicating-with-self-hosted-runners.md
@@ -7,6 +7,8 @@ versions:
   ghes: '*'
   ghec: '*'
 type: overview
+redirect_from:
+  - /actions/hosting-your-own-runners/managing-self-hosted-runners/communicating-with-self-hosted-runners
 ---
 
 A self-hosted runner connects to {% ifversion fpt or ghec %}{% data variables.product.github %}{% else %}{% data variables.location.product_location_enterprise %}{% endif %} to receive job assignments and to download new versions of the runner application. The self-hosted runner uses an {% ifversion ghes %}HTTP(S){% else %}HTTPS{% endif %} long poll that opens a connection to {% data variables.product.github %} for 50 seconds, and if no response is received, it then times out and creates a new long poll. The application must be running on the machine to accept and run {% data variables.product.prodname_actions %} jobs.
diff --git a/content/actions/concepts/runners/index.md b/content/actions/concepts/runners/index.md
@@ -0,0 +1,16 @@
+---
+title: GitHub Actions Runners
+shortTitle: Runners
+intro: "Learn about the concept of runners in GitHub Actions."
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /about-larger-runners
+  - /about-private-networking-with-github-hosted-runners
+  - /about-self-hosted-runners
+  - /communicating-with-self-hosted-runners
+  - /about-actions-runner-controller
+  - /about-support-for-actions-runner-controller
+---
diff --git a/content/actions/concepts/security/about-secrets.md b/content/actions/concepts/security/about-secrets.md
@@ -5,6 +5,8 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+redirect_from:
+  - /actions/security-for-github-actions/security-guides/about-secrets
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/security/about-security-hardening-with-openid-connect.md b/content/actions/concepts/security/about-security-hardening-with-openid-connect.md
@@ -11,6 +11,7 @@ topics:
   - Security
 redirect_from:
   - /actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect
+  - /actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/security/index.md b/content/actions/concepts/security/index.md
@@ -0,0 +1,12 @@
+---
+title: Security in GitHub Actions
+shortTitle: Security
+intro: "Learn about security as a concept in GitHub Actions."
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /about-secrets
+  - /about-security-hardening-with-openid-connect
+---
diff --git a/content/actions/concepts/use-cases/about-packaging-with-github-actions.md b/content/actions/concepts/use-cases/about-packaging-with-github-actions.md
@@ -6,6 +6,7 @@ redirect_from:
   - /actions/publishing-packages-with-github-actions/about-packaging-with-github-actions
   - /actions/guides/about-packaging-with-github-actions
   - /actions/publishing-packages/about-packaging-with-github-actions
+  - /actions/use-cases-and-examples/publishing-packages/about-packaging-with-github-actions
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/concepts/use-cases/about-service-containers.md b/content/actions/concepts/use-cases/about-service-containers.md
@@ -6,6 +6,7 @@ redirect_from:
   - /actions/configuring-and-managing-workflows/about-service-containers
   - /actions/guides/about-service-containers
   - /actions/using-containerized-services/about-service-containers
+  - /actions/use-cases-and-examples/using-containerized-services/about-service-containers
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/concepts/use-cases/deploying-with-github-actions.md b/content/actions/concepts/use-cases/deploying-with-github-actions.md
@@ -9,6 +9,7 @@ type: overview
 redirect_from:
   - /actions/deployment/deploying-with-github-actions
   - /actions/deployment/about-deployments/deploying-with-github-actions
+  - /actions/use-cases-and-examples/deploying/deploying-with-github-actions
 topics:
   - CD
   - Deployment
diff --git a/content/actions/concepts/use-cases/index.md b/content/actions/concepts/use-cases/index.md
@@ -0,0 +1,14 @@
+---
+title: Use cases for GitHub Actions
+shortTitle: Use cases
+intro: "Learn about the real-world applications of GitHub Actions."
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /deploying-with-github-actions
+  - /about-packaging-with-github-actions
+  - /using-github-actions-for-project-management
+  - /about-service-containers
+---
diff --git a/content/actions/concepts/use-cases/using-github-actions-for-project-management.md b/content/actions/concepts/use-cases/using-github-actions-for-project-management.md
@@ -4,6 +4,7 @@ intro: 'You can use {% data variables.product.prodname_actions %} to automate ma
 redirect_from:
   - /actions/guides/using-github-actions-for-project-management
   - /actions/managing-issues-and-pull-requests/using-github-actions-for-project-management
+  - /actions/use-cases-and-examples/project-management/using-github-actions-for-project-management
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/concepts/workflows-and-actions/about-custom-actions.md b/content/actions/concepts/workflows-and-actions/about-custom-actions.md
@@ -8,6 +8,7 @@ redirect_from:
   - /actions/building-actions/about-actions
   - /actions/creating-actions/about-actions
   - /actions/creating-actions/about-custom-actions
+  - /actions/sharing-automations/creating-actions/about-custom-actions
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/concepts/workflows-and-actions/about-monitoring-workflows.md b/content/actions/concepts/workflows-and-actions/about-monitoring-workflows.md
@@ -6,6 +6,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: About monitoring
+redirect_from:
+  - /actions/monitoring-and-troubleshooting-workflows/monitoring-workflows/about-monitoring-workflows
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/workflows-and-actions/about-troubleshooting-workflows.md b/content/actions/concepts/workflows-and-actions/about-troubleshooting-workflows.md
@@ -6,6 +6,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: About troubleshooting
+redirect_from:
+  - /actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/about-troubleshooting-workflows
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/workflows-and-actions/about-workflows.md b/content/actions/concepts/workflows-and-actions/about-workflows.md
@@ -12,6 +12,7 @@ redirect_from:
   - /actions/learn-github-actions/managing-complex-workflows
   - /actions/using-workflows/advanced-workflow-features
   - /actions/using-workflows/about-workflows
+  - /actions/writing-workflows/about-workflows
 topics:
   - Workflows
 layout: inline
diff --git a/content/actions/concepts/workflows-and-actions/avoiding-duplication.md b/content/actions/concepts/workflows-and-actions/avoiding-duplication.md
@@ -11,6 +11,7 @@ topics:
   - Workflows
 redirect_from:
   - /actions/using-workflows/avoiding-duplication
+  - /actions/sharing-automations/avoiding-duplication
 ---
 
 ## About reusable workflows and composite actions
diff --git a/content/actions/concepts/workflows-and-actions/index.md b/content/actions/concepts/workflows-and-actions/index.md
@@ -0,0 +1,15 @@
+---
+title: Workflows and actions
+intro: "Learn about the concepts of workflows and actions in GitHub Actions."
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /about-workflows
+  - /avoiding-duplication
+  - /about-custom-actions
+  - /about-monitoring-workflows
+  - /notifications-for-workflow-runs
+  - /about-troubleshooting-workflows
+---
diff --git a/content/actions/concepts/workflows-and-actions/notifications-for-workflow-runs.md b/content/actions/concepts/workflows-and-actions/notifications-for-workflow-runs.md
@@ -8,6 +8,7 @@ versions:
   ghec: '*'
 redirect_from:
   - /actions/monitoring-and-troubleshooting-workflows/notifications-for-workflow-runs
+  - /actions/monitoring-and-troubleshooting-workflows/monitoring-workflows/notifications-for-workflow-runs
 ---
  
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/guides.md b/content/actions/guides.md
@@ -20,10 +20,10 @@ includeGuides:
   - /actions/writing-workflows/using-workflow-templates
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-python
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-nodejs
-  - /actions/use-cases-and-examples/publishing-packages/about-packaging-with-github-actions
+  - /actions/concepts/use-cases/about-packaging-with-github-actions
   - /actions/use-cases-and-examples/publishing-packages/publishing-docker-images
   - /actions/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows
-  - /actions/about-github-actions/about-continuous-integration-with-github-actions
+  - /actions/concepts/overview/about-continuous-integration-with-github-actions
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-powershell
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-ruby
   - /actions/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven
@@ -36,20 +36,20 @@ includeGuides:
   - /actions/use-cases-and-examples/publishing-packages/publishing-java-packages-with-maven
   - /actions/use-cases-and-examples/publishing-packages/publishing-java-packages-with-gradle
   - /actions/writing-workflows/choosing-what-your-workflow-does/storing-and-sharing-data-from-a-workflow
-  - /actions/use-cases-and-examples/using-containerized-services/about-service-containers
+  - /actions/concepts/use-cases/about-service-containers
   - /actions/use-cases-and-examples/using-containerized-services/creating-redis-service-containers
   - /actions/use-cases-and-examples/using-containerized-services/creating-postgresql-service-containers
   - /actions/use-cases-and-examples/deploying/deploying-to-amazon-elastic-container-service
   - /actions/use-cases-and-examples/deploying/deploying-to-google-kubernetes-engine
-  - /actions/sharing-automations/creating-actions/about-custom-actions
+  - /actions/concepts/workflows-and-actions/about-custom-actions
   - /actions/sharing-automations/creating-actions/creating-a-javascript-action
   - /actions/sharing-automations/creating-actions/creating-a-composite-action
   - /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions
   - /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-circleci-to-github-actions
   - /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions
   - /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-jenkins-to-github-actions
   - /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-travis-ci-to-github-actions
-  - /actions/use-cases-and-examples/project-management/using-github-actions-for-project-management
+  - /actions/concepts/use-cases/using-github-actions-for-project-management
   - /actions/use-cases-and-examples/project-management/closing-inactive-issues
   - /actions/use-cases-and-examples/project-management/scheduling-issue-creation
   - /actions/use-cases-and-examples/project-management/adding-labels-to-issues
diff --git a/content/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/index.md b/content/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/index.md
@@ -9,13 +9,11 @@ versions:
 topics:
   - Actions Runner Controller
 children:
-  - /about-actions-runner-controller
   - /quickstart-for-actions-runner-controller
   - /authenticating-to-the-github-api
   - /deploying-runner-scale-sets-with-actions-runner-controller
   - /using-actions-runner-controller-runners-in-a-workflow
   - /troubleshooting-actions-runner-controller-errors
-  - /about-support-for-actions-runner-controller
 ---
  
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/hosting-your-own-runners/managing-self-hosted-runners/index.md b/content/actions/hosting-your-own-runners/managing-self-hosted-runners/index.md
@@ -7,8 +7,6 @@ versions:
   ghes: '*'
   ghec: '*'
 children:
-  - /about-self-hosted-runners
-  - /communicating-with-self-hosted-runners
   - /adding-self-hosted-runners
   - /autoscaling-with-self-hosted-runners
   - /running-scripts-before-or-after-a-job
diff --git a/content/actions/index.md b/content/actions/index.md
@@ -9,9 +9,9 @@ featuredLinks:
   startHere:
     - /actions/writing-workflows
     - /actions/use-cases-and-examples
-    - /actions/about-github-actions/about-continuous-integration-with-github-actions
-    - /actions/use-cases-and-examples/deploying/deploying-with-github-actions
-    - /actions/use-cases-and-examples/publishing-packages/about-packaging-with-github-actions
+    - /actions/concepts/overview/about-continuous-integration-with-github-actions
+    - /actions/concepts/use-cases/deploying-with-github-actions
+    - /actions/concepts/use-cases/about-packaging-with-github-actions
     - /actions/monitoring-and-troubleshooting-workflows
   guideCards:
     - /actions/writing-workflows/using-workflow-templates
@@ -37,6 +37,7 @@ versions:
   ghec: '*'
 children:
   - /about-github-actions
+  - /concepts
   - /writing-workflows
   - /managing-workflow-runs-and-deployments
   - /sharing-automations
diff --git a/content/actions/monitoring-and-troubleshooting-workflows/monitoring-workflows/index.md b/content/actions/monitoring-and-troubleshooting-workflows/monitoring-workflows/index.md
@@ -7,8 +7,6 @@ versions:
   ghes: '*'
   ghec: '*'
 children:
-  - /about-monitoring-workflows
-  - /notifications-for-workflow-runs
   - /using-the-visualization-graph
   - /viewing-workflow-run-history
   - /viewing-job-execution-time
diff --git a/content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/index.md b/content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/index.md
@@ -7,7 +7,6 @@ versions:
   ghes: '*'
   ghec: '*'
 children:
-  - /about-troubleshooting-workflows
   - /using-copilot-to-troubleshoot-workflows
   - /enabling-debug-logging
   - /working-with-support-for-github-actions
diff --git a/content/actions/security-for-github-actions/security-guides/index.md b/content/actions/security-for-github-actions/security-guides/index.md
@@ -8,7 +8,6 @@ versions:
   ghec: '*'
 children:
   - /security-hardening-for-github-actions
-  - /about-secrets
   - /using-secrets-in-github-actions
   - /automatic-token-authentication
   - /using-githubs-security-features-to-secure-your-use-of-github-actions
diff --git a/content/actions/security-for-github-actions/security-hardening-your-deployments/index.md b/content/actions/security-for-github-actions/security-hardening-your-deployments/index.md
@@ -9,7 +9,6 @@ versions:
   ghec: '*'
   ghes: '*'
 children:
-  - /about-security-hardening-with-openid-connect
   - /configuring-openid-connect-in-amazon-web-services
   - /configuring-openid-connect-in-azure
   - /configuring-openid-connect-in-google-cloud-platform
diff --git a/content/actions/sharing-automations/creating-actions/index.md b/content/actions/sharing-automations/creating-actions/index.md
diff --git a/content/actions/sharing-automations/index.md b/content/actions/sharing-automations/index.md
diff --git a/content/actions/use-cases-and-examples/deploying/index.md b/content/actions/use-cases-and-examples/deploying/index.md
diff --git a/content/actions/use-cases-and-examples/project-management/index.md b/content/actions/use-cases-and-examples/project-management/index.md
diff --git a/content/actions/use-cases-and-examples/publishing-packages/index.md b/content/actions/use-cases-and-examples/publishing-packages/index.md
diff --git a/content/actions/use-cases-and-examples/using-containerized-services/index.md b/content/actions/use-cases-and-examples/using-containerized-services/index.md
diff --git a/content/actions/using-github-hosted-runners/connecting-to-a-private-network/index.md b/content/actions/using-github-hosted-runners/connecting-to-a-private-network/index.md
diff --git a/content/actions/using-github-hosted-runners/using-larger-runners/index.md b/content/actions/using-github-hosted-runners/using-larger-runners/index.md
diff --git a/content/actions/writing-workflows/index.md b/content/actions/writing-workflows/index.md
diff --git a/data/learning-tracks/actions.yml b/data/learning-tracks/actions.yml
