From 00ac39744052bece4d1a46e466bf06b9ecf5eb86 Mon Sep 17 00:00:00 2001
From: Sam Browning <106113886+sabrowning1@users.noreply.github.com>
Date: Fri, 25 Jul 2025 12:39:36 -0400
Subject: [PATCH 1/3] EDI-ify "Reference" in the Actions docs (#56847)

---
 content/actions/index.md                      |  3 ++-
 .../custom-transformers.md}                   |  3 ++-
 .../github-actions-importer/index.md          | 12 +++++++++
 .../supplemental-arguments-and-settings.md    |  1 +
 content/actions/reference/index.md            | 26 ++++---------------
 .../{actions-limits.md => limits.md}          |  3 ++-
 .../github-hosted-runners.md}                 |  4 ++-
 content/actions/reference/runners/index.md    | 13 ++++++++++
 .../larger-runners.md}                        |  4 ++-
 .../self-hosted-runners.md}                   |  3 ++-
 content/actions/reference/security/index.md   | 13 ++++++++++
 .../oidc.md}                                  |  6 +++--
 .../secrets.md}                               |  4 ++-
 .../secure-use.md}                            |  1 +
 .../contexts.md}                              |  3 ++-
 .../dependency-caching.md}                    |  5 ++--
 .../deployments-and-environments.md           |  2 ++
 .../dockerfile-support.md}                    |  1 +
 .../events-that-trigger-workflows.md          |  2 +-
 .../expressions.md}                           |  5 ++--
 .../reference/workflows-and-actions/index.md  | 22 ++++++++++++++++
 .../metadata-syntax.md}                       |  1 +
 .../reusable-workflows.md}                    |  4 ++-
 .../variables.md}                             |  4 ++-
 .../workflow-cancellation.md}                 |  6 +++--
 .../workflow-commands.md}                     |  1 +
 .../workflow-syntax.md}                       |  1 +
 data/learning-tracks/admin.yml                |  4 +--
 28 files changed, 115 insertions(+), 42 deletions(-)
 rename content/actions/reference/{extending-github-actions-importer-with-custom-transformers.md => github-actions-importer/custom-transformers.md} (98%)
 create mode 100644 content/actions/reference/github-actions-importer/index.md
 rename content/actions/reference/{ => github-actions-importer}/supplemental-arguments-and-settings.md (99%)
 rename content/actions/reference/{actions-limits.md => limits.md} (99%)
 rename content/actions/reference/{github-hosted-runners-reference.md => runners/github-hosted-runners.md} (98%)
 create mode 100644 content/actions/reference/runners/index.md
 rename content/actions/reference/{larger-runners-reference.md => runners/larger-runners.md} (98%)
 rename content/actions/reference/{self-hosted-runners-reference.md => runners/self-hosted-runners.md} (99%)
 create mode 100644 content/actions/reference/security/index.md
 rename content/actions/reference/{openid-connect-reference.md => security/oidc.md} (99%)
 rename content/actions/reference/{secrets-reference.md => security/secrets.md} (97%)
 rename content/actions/reference/{secure-use-reference.md => security/secure-use.md} (99%)
 rename content/actions/reference/{contexts-reference.md => workflows-and-actions/contexts.md} (99%)
 rename content/actions/reference/{dependency-caching-reference.md => workflows-and-actions/dependency-caching.md} (99%)
 rename content/actions/reference/{ => workflows-and-actions}/deployments-and-environments.md (99%)
 rename content/actions/reference/{dockerfile-support-for-github-actions.md => workflows-and-actions/dockerfile-support.md} (99%)
 rename content/actions/reference/{ => workflows-and-actions}/events-that-trigger-workflows.md (99%)
 rename content/actions/reference/{evaluate-expressions-in-workflows-and-actions.md => workflows-and-actions/expressions.md} (98%)
 create mode 100644 content/actions/reference/workflows-and-actions/index.md
 rename content/actions/reference/{metadata-syntax-reference.md => workflows-and-actions/metadata-syntax.md} (99%)
 rename content/actions/reference/{reusable-workflows-reference.md => workflows-and-actions/reusable-workflows.md} (98%)
 rename content/actions/reference/{variables-reference.md => workflows-and-actions/variables.md} (99%)
 rename content/actions/reference/{workflow-cancellation-reference.md => workflows-and-actions/workflow-cancellation.md} (89%)
 rename content/actions/reference/{workflow-commands-for-github-actions.md => workflows-and-actions/workflow-commands.md} (99%)
 rename content/actions/reference/{workflow-syntax-for-github-actions.md => workflows-and-actions/workflow-syntax.md} (99%)

diff --git a/content/actions/index.md b/content/actions/index.md
index 0b08385b8619..9da8fd7801be 100644
--- a/content/actions/index.md
+++ b/content/actions/index.md
@@ -16,7 +16,7 @@ featuredLinks:
     - /actions/tutorials/publishing-packages/publishing-nodejs-packages
     - /actions/tutorials/build-and-test-code/building-and-testing-powershell
   popular:
-    - /actions/reference/workflow-syntax-for-github-actions
+    - /actions/reference/workflows-and-actions/workflow-syntax
     - /actions/how-tos/write-workflows
 changelog:
   label: actions
@@ -39,3 +39,4 @@ children:
   - /reference
   - /tutorials
 ---
+
diff --git a/content/actions/reference/extending-github-actions-importer-with-custom-transformers.md b/content/actions/reference/github-actions-importer/custom-transformers.md
similarity index 98%
rename from content/actions/reference/extending-github-actions-importer-with-custom-transformers.md
rename to content/actions/reference/github-actions-importer/custom-transformers.md
index 28c82d2ce6d3..f3abdc0858c7 100644
--- a/content/actions/reference/extending-github-actions-importer-with-custom-transformers.md
+++ b/content/actions/reference/github-actions-importer/custom-transformers.md
@@ -10,11 +10,12 @@ topics:
   - Migration
   - CI
   - CD
-shortTitle: Extending GitHub Actions Importer
+shortTitle: Custom transformers
 redirect_from:
   - /actions/migrating-to-github-actions/automated-migrations/extending-github-actions-importer-with-custom-transformers
   - /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/extending-github-actions-importer-with-custom-transformers
   - /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/extending-github-actions-importer-with-custom-transformers
+  - /actions/reference/extending-github-actions-importer-with-custom-transformers
 ---
 
 ## About custom transformers
diff --git a/content/actions/reference/github-actions-importer/index.md b/content/actions/reference/github-actions-importer/index.md
new file mode 100644
index 000000000000..ddde9dd9ba3f
--- /dev/null
+++ b/content/actions/reference/github-actions-importer/index.md
@@ -0,0 +1,12 @@
+---
+title: GitHub Actions Importer reference
+shortTitle: GitHub Actions Importer
+intro: Find information on migrating your CI/CD pipeline to GitHub Actions with the GitHub Actions Importer.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /supplemental-arguments-and-settings
+  - /custom-transformers
+---
diff --git a/content/actions/reference/supplemental-arguments-and-settings.md b/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
similarity index 99%
rename from content/actions/reference/supplemental-arguments-and-settings.md
rename to content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
index c8d2f4dce080..bda81f7fac35 100644
--- a/content/actions/reference/supplemental-arguments-and-settings.md
+++ b/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
@@ -13,6 +13,7 @@ topics:
 redirect_from:
   - /actions/migrating-to-github-actions/automated-migrations/supplemental-arguments-and-settings
   - /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/supplemental-arguments-and-settings
+  - /actions/reference/supplemental-arguments-and-settings
 ---
 
 This article provides general information for configuring {% data variables.product.prodname_actions_importer %}'s supplemental arguments and settings, such as optional parameters, path arguments, and network settings.
diff --git a/content/actions/reference/index.md b/content/actions/reference/index.md
index ebc2dda4159b..69c156d12d75 100644
--- a/content/actions/reference/index.md
+++ b/content/actions/reference/index.md
@@ -7,25 +7,9 @@ versions:
   ghes: '*'
   ghec: '*'
 children:
-  - /secure-use-reference
-  - /workflow-syntax-for-github-actions
-  - /events-that-trigger-workflows
-  - /workflow-commands-for-github-actions
-  - /variables-reference
-  - /secrets-reference
-  - /evaluate-expressions-in-workflows-and-actions
-  - /contexts-reference
-  - /deployments-and-environments
-  - /dependency-caching-reference
-  - /metadata-syntax-reference
-  - /actions-limits
-  - /reusable-workflows-reference
-  - /openid-connect-reference
-  - /dockerfile-support-for-github-actions
-  - /github-hosted-runners-reference
-  - /larger-runners-reference
-  - /self-hosted-runners-reference
-  - /supplemental-arguments-and-settings
-  - /extending-github-actions-importer-with-custom-transformers
-  - /workflow-cancellation-reference
+  - /workflows-and-actions
+  - /runners
+  - /security
+  - /limits
+  - /github-actions-importer
 ---
diff --git a/content/actions/reference/actions-limits.md b/content/actions/reference/limits.md
similarity index 99%
rename from content/actions/reference/actions-limits.md
rename to content/actions/reference/limits.md
index 41c6ed618861..8316ea67e49c 100644
--- a/content/actions/reference/actions-limits.md
+++ b/content/actions/reference/limits.md
@@ -5,11 +5,12 @@ redirect_from:
   - /actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/actions-limits
   - /actions/hosting-your-own-runners/managing-self-hosted-runners/usage-limits-for-self-hosted-runners
   - /actions/reference/usage-limits-for-self-hosted-runners
+  - /actions/reference/actions-limits
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-shortTitle: Actions limits
+shortTitle: Limits
 ---
 
 You may be rate limited by {% data variables.product.prodname_actions %} when you scale your usage. Some limits can be increased by contacting {% data variables.contact.contact_support %}.
diff --git a/content/actions/reference/github-hosted-runners-reference.md b/content/actions/reference/runners/github-hosted-runners.md
similarity index 98%
rename from content/actions/reference/github-hosted-runners-reference.md
rename to content/actions/reference/runners/github-hosted-runners.md
index de08982a09d2..45718df06de7 100644
--- a/content/actions/reference/github-hosted-runners-reference.md
+++ b/content/actions/reference/runners/github-hosted-runners.md
@@ -1,11 +1,13 @@
 ---
 title: GitHub-hosted runners reference
-shortTitle: GitHub-hosted runners reference
+shortTitle: GitHub-hosted runners
 intro: 'Find information about {% data variables.product.github %}-hosted runners, including their specifications and customization options.'
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+redirect_from:
+  - /actions/reference/github-hosted-runners-reference
 ---
 
 {% ifversion ghes %}
diff --git a/content/actions/reference/runners/index.md b/content/actions/reference/runners/index.md
new file mode 100644
index 000000000000..1cc77f089678
--- /dev/null
+++ b/content/actions/reference/runners/index.md
@@ -0,0 +1,13 @@
+---
+title: Runners reference
+shortTitle: Runners
+intro: Find information on the machines that execute jobs in GitHub Actions.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /github-hosted-runners
+  - /larger-runners
+  - /self-hosted-runners
+---
diff --git a/content/actions/reference/larger-runners-reference.md b/content/actions/reference/runners/larger-runners.md
similarity index 98%
rename from content/actions/reference/larger-runners-reference.md
rename to content/actions/reference/runners/larger-runners.md
index c9d55e5ea650..a691e8cad003 100644
--- a/content/actions/reference/larger-runners-reference.md
+++ b/content/actions/reference/runners/larger-runners.md
@@ -1,11 +1,13 @@
 ---
 title: Larger runners reference
-shortTitle: Larger runners reference
+shortTitle: Larger runners
 intro: 'Find information about larger runners, including their specifications and customization options.'
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+redirect_from:
+  - /actions/reference/larger-runners-reference
 ---
 
 {% ifversion ghes %}
diff --git a/content/actions/reference/self-hosted-runners-reference.md b/content/actions/reference/runners/self-hosted-runners.md
similarity index 99%
rename from content/actions/reference/self-hosted-runners-reference.md
rename to content/actions/reference/runners/self-hosted-runners.md
index cc3b06492d53..8924b2df2c9e 100644
--- a/content/actions/reference/self-hosted-runners-reference.md
+++ b/content/actions/reference/runners/self-hosted-runners.md
@@ -1,6 +1,6 @@
 ---
 title: Self-hosted runners reference
-shortTitle: Self-hosted runners reference
+shortTitle: Self-hosted runners
 intro: Find information about setting up and using self-hosted runners.
 redirect_from:
   - /actions/hosting-your-own-runners/managing-self-hosted-runners/supported-architectures-and-operating-systems-for-self-hosted-runners
@@ -10,6 +10,7 @@ redirect_from:
   - /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners/autoscaling-with-self-hosted-runners
   - /actions/hosting-your-own-runners/managing-self-hosted-runners/communicating-with-self-hosted-runners
   - /actions/concepts/runners/communicating-with-self-hosted-runners
+  - /actions/reference/self-hosted-runners-reference
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/reference/security/index.md b/content/actions/reference/security/index.md
new file mode 100644
index 000000000000..4b59ea6b23da
--- /dev/null
+++ b/content/actions/reference/security/index.md
@@ -0,0 +1,13 @@
+---
+title: Security reference
+shortTitle: Security
+intro: Find information about keeping your work with GitHub Actions secure.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /secure-use
+  - /secrets
+  - /oidc
+---
diff --git a/content/actions/reference/openid-connect-reference.md b/content/actions/reference/security/oidc.md
similarity index 99%
rename from content/actions/reference/openid-connect-reference.md
rename to content/actions/reference/security/oidc.md
index 98096b2778e4..bb50714991fa 100644
--- a/content/actions/reference/openid-connect-reference.md
+++ b/content/actions/reference/security/oidc.md
@@ -1,13 +1,15 @@
 ---
 title: OpenID Connect reference
-shortTitle: OpenID Connect reference
-intro: Find information about using OpenID Connect (OIDC) to authenticate {% data variables.product.prodname_actions %} workflows with cloud providers.
+shortTitle: OIDC
+intro: 'Find information about using OpenID Connect (OIDC) to authenticate {% data variables.product.prodname_actions %} workflows with cloud providers.'
 versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
 topics:
   - Security
+redirect_from:
+  - /actions/reference/openid-connect-reference
 ---
 
 ## OIDC token claims
diff --git a/content/actions/reference/secrets-reference.md b/content/actions/reference/security/secrets.md
similarity index 97%
rename from content/actions/reference/secrets-reference.md
rename to content/actions/reference/security/secrets.md
index 1ed6baf4c7e1..448a7def324e 100644
--- a/content/actions/reference/secrets-reference.md
+++ b/content/actions/reference/security/secrets.md
@@ -1,11 +1,13 @@
 ---
 title: Secrets reference
-shortTitle: Secrets reference
+shortTitle: Secrets
 intro: 'Find technical information about secrets in {% data variables.product.prodname_actions %}.'
 versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+redirect_from:
+  - /actions/reference/secrets-reference
 ---
 
 ## Naming your secrets
diff --git a/content/actions/reference/secure-use-reference.md b/content/actions/reference/security/secure-use.md
similarity index 99%
rename from content/actions/reference/secure-use-reference.md
rename to content/actions/reference/security/secure-use.md
index 3f3586c25596..8876f100de3e 100644
--- a/content/actions/reference/secure-use-reference.md
+++ b/content/actions/reference/security/secure-use.md
@@ -11,6 +11,7 @@ redirect_from:
   - /actions/security-guides/using-githubs-security-features-to-secure-your-use-of-github-actions
   - /actions/security-for-github-actions/security-guides/using-githubs-security-features-to-secure-your-use-of-github-actions
   - /actions/how-tos/security-for-github-actions/security-guides/using-githubs-security-features-to-secure-your-use-of-github-actions
+  - /actions/reference/secure-use-reference
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/reference/contexts-reference.md b/content/actions/reference/workflows-and-actions/contexts.md
similarity index 99%
rename from content/actions/reference/contexts-reference.md
rename to content/actions/reference/workflows-and-actions/contexts.md
index 81a9fc9fd659..bf278a4a4696 100644
--- a/content/actions/reference/contexts-reference.md
+++ b/content/actions/reference/workflows-and-actions/contexts.md
@@ -1,6 +1,6 @@
 ---
 title: Contexts reference
-shortTitle: Contexts reference
+shortTitle: Contexts
 intro: 'Find information about contexts available in {% data variables.product.prodname_actions %} workflows, including available properties, access methods, and usage examples.'
 redirect_from:
   - /articles/contexts-and-expression-syntax-for-github-actions
@@ -12,6 +12,7 @@ redirect_from:
   - /actions/writing-workflows/choosing-what-your-workflow-does/contexts
   - /actions/writing-workflows/choosing-what-your-workflow-does/accessing-contextual-information-about-workflow-runs
   - /actions/reference/accessing-contextual-information-about-workflow-runs
+  - /actions/reference/contexts-reference
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/reference/dependency-caching-reference.md b/content/actions/reference/workflows-and-actions/dependency-caching.md
similarity index 99%
rename from content/actions/reference/dependency-caching-reference.md
rename to content/actions/reference/workflows-and-actions/dependency-caching.md
index 659a93369d8c..3d975b8c8f5b 100644
--- a/content/actions/reference/dependency-caching-reference.md
+++ b/content/actions/reference/workflows-and-actions/dependency-caching.md
@@ -1,7 +1,7 @@
 ---
 title: Dependency caching reference
-shortTitle: Dependency caching reference
-intro: 'Find information on the functionality of dependency caching in workflows.'
+shortTitle: Dependency caching
+intro: Find information on the functionality of dependency caching in workflows.
 redirect_from:
   - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
   - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows
@@ -11,6 +11,7 @@ redirect_from:
   - /actions/using-workflows/caching-dependencies-to-speed-up-workflows
   - /actions/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows
   - /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows
+  - /actions/reference/dependency-caching-reference
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/reference/deployments-and-environments.md b/content/actions/reference/workflows-and-actions/deployments-and-environments.md
similarity index 99%
rename from content/actions/reference/deployments-and-environments.md
rename to content/actions/reference/workflows-and-actions/deployments-and-environments.md
index 4386f068b85a..c09c1eab9e1d 100644
--- a/content/actions/reference/deployments-and-environments.md
+++ b/content/actions/reference/workflows-and-actions/deployments-and-environments.md
@@ -6,6 +6,8 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+redirect_from:
+  - /actions/reference/deployments-and-environments
 ---
 
 ## Deployment protection rules
diff --git a/content/actions/reference/dockerfile-support-for-github-actions.md b/content/actions/reference/workflows-and-actions/dockerfile-support.md
similarity index 99%
rename from content/actions/reference/dockerfile-support-for-github-actions.md
rename to content/actions/reference/workflows-and-actions/dockerfile-support.md
index fccce94139f7..ff859e6cdb2e 100644
--- a/content/actions/reference/dockerfile-support-for-github-actions.md
+++ b/content/actions/reference/workflows-and-actions/dockerfile-support.md
@@ -6,6 +6,7 @@ redirect_from:
   - /actions/building-actions/dockerfile-support-for-github-actions
   - /actions/creating-actions/dockerfile-support-for-github-actions
   - /actions/sharing-automations/creating-actions/dockerfile-support-for-github-actions
+  - /actions/reference/dockerfile-support-for-github-actions
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/reference/events-that-trigger-workflows.md b/content/actions/reference/workflows-and-actions/events-that-trigger-workflows.md
similarity index 99%
rename from content/actions/reference/events-that-trigger-workflows.md
rename to content/actions/reference/workflows-and-actions/events-that-trigger-workflows.md
index a9e70d2c23b6..8c4fe351820b 100644
--- a/content/actions/reference/events-that-trigger-workflows.md
+++ b/content/actions/reference/workflows-and-actions/events-that-trigger-workflows.md
@@ -8,11 +8,11 @@ redirect_from:
   - /actions/learn-github-actions/events-that-trigger-workflows
   - /actions/using-workflows/events-that-trigger-workflows
   - /actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows
+  - /actions/reference/events-that-trigger-workflows
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-shortTitle: Events that trigger workflows
 ---
 
 ## About events that trigger workflows
diff --git a/content/actions/reference/evaluate-expressions-in-workflows-and-actions.md b/content/actions/reference/workflows-and-actions/expressions.md
similarity index 98%
rename from content/actions/reference/evaluate-expressions-in-workflows-and-actions.md
rename to content/actions/reference/workflows-and-actions/expressions.md
index dbfd6ae9843e..079897e98a80 100644
--- a/content/actions/reference/evaluate-expressions-in-workflows-and-actions.md
+++ b/content/actions/reference/workflows-and-actions/expressions.md
@@ -1,7 +1,7 @@
 ---
 title: Evaluate expressions in workflows and actions
-shortTitle: Expressions reference
-intro: Find information for expressions in {% data variables.product.prodname_actions %}.
+shortTitle: Expressions
+intro: 'Find information for expressions in {% data variables.product.prodname_actions %}.'
 versions:
   fpt: '*'
   ghes: '*'
@@ -10,6 +10,7 @@ redirect_from:
   - /actions/learn-github-actions/expressions
   - /actions/writing-workflows/choosing-what-your-workflow-does/expressions
   - /actions/writing-workflows/choosing-what-your-workflow-does/evaluate-expressions-in-workflows-and-actions
+  - /actions/reference/evaluate-expressions-in-workflows-and-actions
 ---
 
 ## Literals
diff --git a/content/actions/reference/workflows-and-actions/index.md b/content/actions/reference/workflows-and-actions/index.md
new file mode 100644
index 000000000000..d5a044927707
--- /dev/null
+++ b/content/actions/reference/workflows-and-actions/index.md
@@ -0,0 +1,22 @@
+---
+title: Workflows and actions reference
+shortTitle: Workflows and actions
+intro: Find information on workflows and actions in GitHub Actions.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /workflow-syntax
+  - /events-that-trigger-workflows
+  - /workflow-commands
+  - /variables
+  - /expressions
+  - /contexts
+  - /deployments-and-environments
+  - /dependency-caching
+  - /reusable-workflows
+  - /metadata-syntax
+  - /workflow-cancellation
+  - /dockerfile-support
+---
diff --git a/content/actions/reference/metadata-syntax-reference.md b/content/actions/reference/workflows-and-actions/metadata-syntax.md
similarity index 99%
rename from content/actions/reference/metadata-syntax-reference.md
rename to content/actions/reference/workflows-and-actions/metadata-syntax.md
index 4a03b83059d1..e779a4f8b9e8 100644
--- a/content/actions/reference/metadata-syntax-reference.md
+++ b/content/actions/reference/workflows-and-actions/metadata-syntax.md
@@ -10,6 +10,7 @@ redirect_from:
   - /actions/creating-actions/metadata-syntax-for-github-actions
   - /actions/sharing-automations/creating-actions/metadata-syntax-for-github-actions
   - /actions/reference/metadata-syntax-for-github-actions
+  - /actions/reference/metadata-syntax-reference
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/reference/reusable-workflows-reference.md b/content/actions/reference/workflows-and-actions/reusable-workflows.md
similarity index 98%
rename from content/actions/reference/reusable-workflows-reference.md
rename to content/actions/reference/workflows-and-actions/reusable-workflows.md
index 48bd474eeace..ca2837f3d04a 100644
--- a/content/actions/reference/reusable-workflows-reference.md
+++ b/content/actions/reference/workflows-and-actions/reusable-workflows.md
@@ -1,11 +1,13 @@
 ---
 title: Reusable workflows reference
-shortTitle: Reusable workflows reference
+shortTitle: Reusable workflows
 intro: Learn how to avoid duplication when creating a workflow by reusing existing workflows.
 versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+redirect_from:
+  - /actions/reference/reusable-workflows-reference
 ---
 
 ## Access to reusable workflows
diff --git a/content/actions/reference/variables-reference.md b/content/actions/reference/workflows-and-actions/variables.md
similarity index 99%
rename from content/actions/reference/variables-reference.md
rename to content/actions/reference/workflows-and-actions/variables.md
index f6c7b6031b1c..293c1672f1a5 100644
--- a/content/actions/reference/variables-reference.md
+++ b/content/actions/reference/workflows-and-actions/variables.md
@@ -1,11 +1,13 @@
 ---
 title: Variables reference
-shortTitle: Variables reference
+shortTitle: Variables
 intro: 'Find information for supported variables, naming conventions, limits, and contexts in {% data variables.product.prodname_actions %} workflows.'
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+redirect_from:
+  - /actions/reference/variables-reference
 ---
 
 This article lists the supported variables you can use in {% data variables.product.prodname_actions %} workflows, including environment variables, configuration variables, and default variables provided by {% data variables.product.github %}. Use this reference to look up variable names, naming conventions, limits, and supported contexts when configuring your workflows.
diff --git a/content/actions/reference/workflow-cancellation-reference.md b/content/actions/reference/workflows-and-actions/workflow-cancellation.md
similarity index 89%
rename from content/actions/reference/workflow-cancellation-reference.md
rename to content/actions/reference/workflows-and-actions/workflow-cancellation.md
index ddd3add8d22d..89918b16eaf6 100644
--- a/content/actions/reference/workflow-cancellation-reference.md
+++ b/content/actions/reference/workflows-and-actions/workflow-cancellation.md
@@ -1,11 +1,13 @@
 ---
 title: Workflow cancellation reference
-shortTitle: Workflow cancellation reference
-intro: Find information on the steps {% data variables.product.prodname_dotcom %} takes to cancel a workflow run.
+shortTitle: Workflow cancellation
+intro: 'Find information on the steps {% data variables.product.prodname_dotcom %} takes to cancel a workflow run.'
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+redirect_from:
+  - /actions/reference/workflow-cancellation-reference
 ---
 
 When canceling a workflow run, you may be running other software that uses resources related to the workflow run. To help you free up resources related to the workflow run, it may help to understand the steps {% data variables.product.prodname_dotcom %} performs to cancel a workflow run.
diff --git a/content/actions/reference/workflow-commands-for-github-actions.md b/content/actions/reference/workflows-and-actions/workflow-commands.md
similarity index 99%
rename from content/actions/reference/workflow-commands-for-github-actions.md
rename to content/actions/reference/workflows-and-actions/workflow-commands.md
index 5e89361efd3b..29004a842f75 100644
--- a/content/actions/reference/workflow-commands-for-github-actions.md
+++ b/content/actions/reference/workflows-and-actions/workflow-commands.md
@@ -12,6 +12,7 @@ redirect_from:
   - /actions/learn-github-actions/workflow-commands-for-github-actions
   - /actions/using-workflows/workflow-commands-for-github-actions
   - /actions/writing-workflows/choosing-what-your-workflow-does/workflow-commands-for-github-actions
+  - /actions/reference/workflow-commands-for-github-actions
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/content/actions/reference/workflow-syntax-for-github-actions.md b/content/actions/reference/workflows-and-actions/workflow-syntax.md
similarity index 99%
rename from content/actions/reference/workflow-syntax-for-github-actions.md
rename to content/actions/reference/workflows-and-actions/workflow-syntax.md
index 6e81f2844c03..c17c446f641a 100644
--- a/content/actions/reference/workflow-syntax-for-github-actions.md
+++ b/content/actions/reference/workflows-and-actions/workflow-syntax.md
@@ -10,6 +10,7 @@ redirect_from:
   - /actions/using-workflows/workflow-syntax-for-github-actions
   - /actions/writing-workflows/workflow-syntax-for-github-actions
   - /actions/reference/github_token-reference
+  - /actions/reference/workflow-syntax-for-github-actions
 versions:
   fpt: '*'
   ghes: '*'
diff --git a/data/learning-tracks/admin.yml b/data/learning-tracks/admin.yml
index 4034461901fd..85c7a978cdc0 100644
--- a/data/learning-tracks/admin.yml
+++ b/data/learning-tracks/admin.yml
@@ -52,7 +52,7 @@ adopting_github_actions_for_your_enterprise_ghec:
     - >-
       /admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud
     - >-
-      /actions/reference/secure-use-reference
+      /actions/reference/security/secure-use
     - >-
       /billing/managing-billing-for-your-products/about-billing-for-github-actions
 adopting_github_actions_for_your_enterprise_ghes:
@@ -77,7 +77,7 @@ adopting_github_actions_for_your_enterprise_ghes:
     - >-
       /admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise
     - >-
-      /actions/reference/secure-use-reference
+      /actions/reference/security/secure-use
     - >-
       /billing/managing-billing-for-your-products/about-billing-for-github-actions
 increase_fault_tolerance:

From 72734334956d06cbab71987d9cc59b3d726364f7 Mon Sep 17 00:00:00 2001
From: docs-bot <77750099+docs-bot@users.noreply.github.com>
Date: Fri, 25 Jul 2025 10:00:39 -0700
Subject: [PATCH 2/3] Sync secret scanning data (#56849)

Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com>
---
 src/secret-scanning/data/public-docs.yml | 42 ++++++++++++++++++------
 src/secret-scanning/lib/config.json      |  4 +--
 2 files changed, 34 insertions(+), 12 deletions(-)

diff --git a/src/secret-scanning/data/public-docs.yml b/src/secret-scanning/data/public-docs.yml
index 7a6344366d4e..14424f72f079 100644
--- a/src/secret-scanning/data/public-docs.yml
+++ b/src/secret-scanning/data/public-docs.yml
@@ -3758,9 +3758,9 @@
     ghes: '>=3.17'
   isPublic: true
   isPrivateWithGhas: true
-  hasPushProtection: false
+  hasPushProtection: true
   hasValidityCheck: false
-  isduplicate: false
+  isduplicate: true
 - provider: Polar
   supportedSecret: Polar Authorization Code
   secretType: polar_authorization_code
@@ -3770,9 +3770,9 @@
     ghes: '>=3.17'
   isPublic: true
   isPrivateWithGhas: true
-  hasPushProtection: false
+  hasPushProtection: true
   hasValidityCheck: false
-  isduplicate: false
+  isduplicate: true
 - provider: Polar
   supportedSecret: Polar Client Registration Token
   secretType: polar_client_registration_token
@@ -3782,9 +3782,9 @@
     ghes: '>=3.17'
   isPublic: true
   isPrivateWithGhas: true
-  hasPushProtection: false
+  hasPushProtection: true
   hasValidityCheck: false
-  isduplicate: false
+  isduplicate: true
 - provider: Polar
   supportedSecret: Polar Client Secret
   secretType: polar_client_secret
@@ -3794,7 +3794,18 @@
     ghes: '>=3.17'
   isPublic: true
   isPrivateWithGhas: true
-  hasPushProtection: false
+  hasPushProtection: true
+  hasValidityCheck: false
+  isduplicate: true
+- provider: Polar
+  supportedSecret: Polar Customer Session Token
+  secretType: polar_customer_session_token
+  versions:
+    fpt: '*'
+    ghec: '*'
+  isPublic: true
+  isPrivateWithGhas: true
+  hasPushProtection: true
   hasValidityCheck: false
   isduplicate: false
 - provider: Polar
@@ -3806,9 +3817,9 @@
     ghes: '>=3.17'
   isPublic: true
   isPrivateWithGhas: true
-  hasPushProtection: false
+  hasPushProtection: true
   hasValidityCheck: false
-  isduplicate: false
+  isduplicate: true
 - provider: Polar
   supportedSecret: Polar Refresh Token
   secretType: polar_refresh_token
@@ -3818,7 +3829,18 @@
     ghes: '>=3.17'
   isPublic: true
   isPrivateWithGhas: true
-  hasPushProtection: false
+  hasPushProtection: true
+  hasValidityCheck: false
+  isduplicate: true
+- provider: Polar
+  supportedSecret: Polar User Session Token
+  secretType: polar_user_session_token
+  versions:
+    fpt: '*'
+    ghec: '*'
+  isPublic: true
+  isPrivateWithGhas: true
+  hasPushProtection: true
   hasValidityCheck: false
   isduplicate: false
 - provider: Postman
diff --git a/src/secret-scanning/lib/config.json b/src/secret-scanning/lib/config.json
index 0f4577e2fef3..087118648827 100644
--- a/src/secret-scanning/lib/config.json
+++ b/src/secret-scanning/lib/config.json
@@ -1,5 +1,5 @@
 {
-  "sha": "b655b59f8f4ad71b005f30ebf63c28e136007121",
-  "blob-sha": "0a7c5db3e22d67a8d5c72499643d362bb9845fa6",
+  "sha": "594adea0c1c940527d547efc18db839af86d8b79",
+  "blob-sha": "3feedd6d151816923eec708ffa058b4b2cc87184",
   "targetFilename": "code-security/secret-scanning/introduction/supported-secret-scanning-patterns"
 }
\ No newline at end of file

From fbc7cca92b06bd9ec0dc5a565d4a631098dd91c2 Mon Sep 17 00:00:00 2001
From: Wechuli <wechuli@github.com>
Date: Fri, 25 Jul 2025 20:53:34 +0300
Subject: [PATCH 3/3] Update Docs on runner image to clarify that runner
 container must be named `runner` (#56794)

Co-authored-by: John Clement <70238417+jclement136@users.noreply.github.com>
---
 ...ing-runner-scale-sets-with-actions-runner-controller.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/content/actions/tutorials/actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller.md b/content/actions/tutorials/actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller.md
index ddeb091bdcb9..5da4c32ed1a2 100644
--- a/content/actions/tutorials/actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller.md
+++ b/content/actions/tutorials/actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller.md
@@ -359,7 +359,12 @@ The listener container inherits the `imagePullPolicy` defined for the controller
 
 #### Configuring the runner image
 
-You can update your copy of the [`values.yaml`](https://github.com/actions/actions-runner-controller/blob/master/charts/gha-runner-scale-set/values.yaml) file and set the `template.spec` properties as follows.
+You can update your copy of the [`values.yaml`](https://github.com/actions/actions-runner-controller/blob/master/charts/gha-runner-scale-set/values.yaml) file and set the `template.spec` properties to configure the runner pod for your specific use case.
+
+> [!NOTE]
+> The runner container must be named `runner`. Otherwise, it will not be configured properly to connect to {% data variables.product.prodname_dotcom %}.
+
+The following is a sample configuration:
 
 ```yaml
 template: