Repo sync

content/actions/hosting-your-own-runners/managing-self-hosted-runners/index.md

@@ -9,8 +9,6 @@ versions:
 children:
   - /about-self-hosted-runners
   - /communicating-with-self-hosted-runners
-  - /supported-architectures-and-operating-systems-for-self-hosted-runners
-  - /usage-limits-for-self-hosted-runners
   - /adding-self-hosted-runners
   - /autoscaling-with-self-hosted-runners
   - /running-scripts-before-or-after-a-job

content/actions/index.md

@@ -18,7 +18,7 @@ featuredLinks:
     - /actions/use-cases-and-examples/publishing-packages/publishing-nodejs-packages
     - /actions/use-cases-and-examples/building-and-testing/building-and-testing-powershell
   popular:
-    - /actions/writing-workflows/workflow-syntax-for-github-actions
+    - /actions/reference/workflow-syntax-for-github-actions
     - /actions/writing-workflows
     - /actions/use-cases-and-examples
 changelog:
@@ -30,7 +30,6 @@ redirect_from:
   - /actions/automating-your-workflow-with-github-actions
   - /categories/automating-your-workflow-with-github-actions
   - /marketplace/actions
-  - /actions/reference
 layout: product-landing
 versions:
   fpt: '*'
@@ -48,6 +47,7 @@ children:
   - /use-cases-and-examples
   - /migrating-to-github-actions
   - /administering-github-actions
+  - /reference
   - /guides
 ---
 

content/actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/index.md

@@ -9,7 +9,6 @@ versions:
 children:
   - /automating-migration-with-github-actions-importer
   - /extending-github-actions-importer-with-custom-transformers
-  - /supplemental-arguments-and-settings
   - /migrating-from-azure-devops-with-github-actions-importer
   - /migrating-from-bamboo-with-github-actions-importer
   - /migrating-from-bitbucket-pipelines-with-github-actions-importer

content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/index.md

@@ -8,7 +8,6 @@ versions:
   ghec: '*'
 children:
   - /about-troubleshooting-workflows
-  - /actions-limits
   - /using-copilot-to-troubleshoot-workflows
   - /enabling-debug-logging
   - /working-with-support-for-github-actions

content/actions/writing-workflows/choosing-what-your-workflow-does/accessing-contextual-information-about-workflow-runs.md → content/actions/reference/accessing-contextual-information-about-workflow-runs.md

@@ -10,6 +10,7 @@ redirect_from:
   - /actions/reference/context-and-expression-syntax-for-github-actions
   - /actions/learn-github-actions/contexts
   - /actions/writing-workflows/choosing-what-your-workflow-does/contexts
+  - /actions/writing-workflows/choosing-what-your-workflow-does/accessing-contextual-information-about-workflow-runs
 versions:
   fpt: '*'
   ghes: '*'

content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/actions-limits.md → content/actions/reference/actions-limits.md

@@ -1,6 +1,8 @@
 ---
 title: Actions limits
 intro: 'There are limits in {% data variables.product.prodname_actions %} which you may hit as you scale up, some may be increased by contacting support.'
+redirect_from:
+  - /actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/actions-limits
 versions:
   fpt: '*'
   ghes: '*'

content/actions/sharing-automations/creating-actions/dockerfile-support-for-github-actions.md → content/actions/reference/dockerfile-support-for-github-actions.md

@@ -5,6 +5,7 @@ intro: 'When creating a `Dockerfile` for a Docker container action, you should b
 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
 versions:
   fpt: '*'
   ghes: '*'

content/actions/writing-workflows/choosing-what-your-workflow-does/evaluate-expressions-in-workflows-and-actions.md → content/actions/reference/evaluate-expressions-in-workflows-and-actions.md

@@ -9,6 +9,7 @@ versions:
 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
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}

content/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows.md → content/actions/reference/events-that-trigger-workflows.md

@@ -5,9 +5,9 @@ redirect_from:
   - /articles/events-that-trigger-workflows
   - /github/automating-your-workflow-with-github-actions/events-that-trigger-workflows
   - /actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows
-  - /actions/reference/events-that-trigger-workflows
   - /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
 versions:
   fpt: '*'
   ghes: '*'

content/actions/reference/index.md

@@ -0,0 +1,21 @@
+---
+title: Reference for GitHub Actions
+shortTitle: Reference
+intro: "Find information to apply to your work with GitHub Actions."
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /workflow-syntax-for-github-actions
+  - /events-that-trigger-workflows
+  - /workflow-commands-for-github-actions
+  - /evaluate-expressions-in-workflows-and-actions
+  - /accessing-contextual-information-about-workflow-runs
+  - /metadata-syntax-for-github-actions
+  - /actions-limits
+  - /dockerfile-support-for-github-actions
+  - /supported-architectures-and-operating-systems-for-self-hosted-runners
+  - /usage-limits-for-self-hosted-runners
+  - /supplemental-arguments-and-settings
+---

content/actions/sharing-automations/creating-actions/metadata-syntax-for-github-actions.md → content/actions/reference/metadata-syntax-for-github-actions.md

@@ -8,6 +8,7 @@ redirect_from:
   - /actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions
   - /actions/building-actions/metadata-syntax-for-github-actions
   - /actions/creating-actions/metadata-syntax-for-github-actions
+  - /actions/sharing-automations/creating-actions/metadata-syntax-for-github-actions
 versions:
   fpt: '*'
   ghes: '*'

content/actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/supplemental-arguments-and-settings.md → content/actions/reference/supplemental-arguments-and-settings.md

@@ -12,6 +12,7 @@ topics:
   - CD
 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
 ---
 
 [Legal notice](#legal-notice)

content/actions/hosting-your-own-runners/managing-self-hosted-runners/supported-architectures-and-operating-systems-for-self-hosted-runners.md → content/actions/reference/supported-architectures-and-operating-systems-for-self-hosted-runners.md

@@ -2,6 +2,8 @@
 title: Supported architectures and operating systems for self-hosted runners
 shortTitle: Supported platforms
 intro: 'The following processor architectures and operating systems are supported for the self-hosted runner application.'
+redirect_from:
+  - /actions/hosting-your-own-runners/managing-self-hosted-runners/supported-architectures-and-operating-systems-for-self-hosted-runners
 versions:
   fpt: '*'
   ghes: '*'

content/actions/hosting-your-own-runners/managing-self-hosted-runners/usage-limits-for-self-hosted-runners.md → content/actions/reference/usage-limits-for-self-hosted-runners.md

@@ -2,6 +2,8 @@
 title: Usage limits for self-hosted runners
 shortTitle: Usage limits
 intro: 'There are some limits on {% data variables.product.prodname_actions %} usage when using self-hosted runners. These limits are subject to change.'
+redirect_from:
+  - /actions/hosting-your-own-runners/managing-self-hosted-runners/usage-limits-for-self-hosted-runners
 versions:
   fpt: '*'
   ghes: '*'

content/actions/writing-workflows/choosing-what-your-workflow-does/workflow-commands-for-github-actions.md → content/actions/reference/workflow-commands-for-github-actions.md

@@ -9,9 +9,9 @@ redirect_from:
   - /actions/automating-your-workflow-with-github-actions/development-tools-for-github-actions
   - /actions/reference/development-tools-for-github-actions
   - /actions/reference/logging-commands-for-github-actions
-  - /actions/reference/workflow-commands-for-github-actions
   - /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
 versions:
   fpt: '*'
   ghes: '*'

content/actions/writing-workflows/workflow-syntax-for-github-actions.md → content/actions/reference/workflow-syntax-for-github-actions.md

@@ -6,9 +6,9 @@ redirect_from:
   - /articles/workflow-syntax-for-github-actions
   - /github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions
   - /actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions
-  - /actions/reference/workflow-syntax-for-github-actions
   - /actions/learn-github-actions/workflow-syntax-for-github-actions
   - /actions/using-workflows/workflow-syntax-for-github-actions
+  - /actions/writing-workflows/workflow-syntax-for-github-actions
 versions:
   fpt: '*'
   ghes: '*'

content/actions/sharing-automations/creating-actions/index.md

@@ -11,8 +11,6 @@ children:
   - /creating-a-docker-container-action
   - /creating-a-javascript-action
   - /creating-a-composite-action
-  - /metadata-syntax-for-github-actions
-  - /dockerfile-support-for-github-actions
   - /setting-exit-codes-for-actions
   - /releasing-and-maintaining-actions
   - /publishing-actions-in-github-marketplace

content/actions/writing-workflows/choosing-what-your-workflow-does/index.md

@@ -12,12 +12,9 @@ children:
   - /using-jobs-in-a-workflow
   - /using-pre-written-building-blocks-in-your-workflow
   - /using-github-cli-in-workflows
-  - /workflow-commands-for-github-actions
   - /adding-scripts-to-your-workflow
   - /controlling-permissions-for-github_token
-  - /evaluate-expressions-in-workflows-and-actions
   - /store-information-in-variables
-  - /accessing-contextual-information-about-workflow-runs
   - /passing-information-between-jobs
   - /setting-a-default-shell-and-working-directory
   - /using-environments-for-deployment

content/actions/writing-workflows/choosing-when-your-workflow-runs/index.md

@@ -9,6 +9,5 @@ versions:
 children:
   - /triggering-a-workflow
   - /using-conditions-to-control-job-execution
-  - /events-that-trigger-workflows
 ---
 

content/actions/writing-workflows/index.md

@@ -16,6 +16,5 @@ children:
   - /choosing-when-your-workflow-runs
   - /choosing-where-your-workflow-runs
   - /choosing-what-your-workflow-does
-  - /workflow-syntax-for-github-actions
 ---
 

content/admin/configuring-settings/configuring-network-settings/changing-the-hostname-for-your-instance.md

@@ -19,6 +19,8 @@ If you need to use a new hostname for {% data variables.location.product_locatio
 
 Migration to a new instance requires downtime. The amount of downtime required depends on how much data you need to back up, as well as the speed of the network connection between the backup host and the instances.
 
+The new instance cannot directly replace an existing instance in a high availability configuration. Ensuring the new instance is configured with a different IP address to the instance with the old hostname is strongly recommended, and can simplify roll back. In high availability environments, once the restore is complete and the state of the new instance has been validated, you can then proceed with using a fresh appliance, or reconfiguring an existing replica. See [AUTOTITLE](/admin/monitoring-and-managing-your-instance/configuring-high-availability/creating-a-high-availability-replica).
+
 In this article, the term "source instance" refers to the instance with the old hostname, and "destination instance" refers to the instance with the new hostname.
 
 {% data reusables.enterprise_installation.changing-hostname-not-supported %}

data/learning-tracks/actions.yml

@@ -92,9 +92,9 @@ create_actions:
     - /actions/sharing-automations/creating-actions/creating-a-javascript-action
     - /actions/sharing-automations/creating-actions/creating-a-composite-action
     - >-
-      /actions/sharing-automations/creating-actions/metadata-syntax-for-github-actions
+      /actions/reference/metadata-syntax-for-github-actions
     - >-
-      /actions/sharing-automations/creating-actions/dockerfile-support-for-github-actions
+      /actions/reference/dockerfile-support-for-github-actions
     - >-
       /actions/sharing-automations/creating-actions/setting-exit-codes-for-actions
     - >-