EDI-ify "Reference" in the Actions docs (#56847)

sabrowning1 · web-flow · commit 00ac39744052 · 2025-07-25T16:39:36.000Z
diff --git 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/github-actions-importer/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
@@ -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/github-actions-importer/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
@@ -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/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/runners/github-hosted-runners.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
@@ -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/runners/larger-runners.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/runners/self-hosted-runners.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
@@ -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/security/oidc.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/security/secrets.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/security/secure-use.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/workflows-and-actions/contexts.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/workflows-and-actions/dependency-caching.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/workflows-and-actions/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/workflows-and-actions/dockerfile-support.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/workflows-and-actions/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/workflows-and-actions/expressions.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
@@ -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/workflows-and-actions/metadata-syntax.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/workflows-and-actions/reusable-workflows.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/workflows-and-actions/variables.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/workflows-and-actions/workflow-cancellation.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/workflows-and-actions/workflow-commands.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/workflows-and-actions/workflow-syntax.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
