[EDI] Dockerfile support for GitHub Actions (#56475)

Co-authored-by: Joe Clark <[email protected]>

Author: subatoi

content/actions/how-tos/writing-workflows/choosing-where-your-workflow-runs/running-jobs-in-a-container.md

@@ -17,6 +17,14 @@ redirect_from:
 
 {% data reusables.actions.jobs.section-running-jobs-in-a-container %}
 
+### Dockerfile instructions and overrides
+
+A Dockerfile contains instructions and arguments that define the contents and startup behavior of a Docker container. For more information about the instructions Docker supports, see [Dockerfile reference](https://docs.docker.com/engine/reference/builder/) in the Docker documentation.
+
+Some Docker instructions interact with {% data variables.product.prodname_actions %}, and an action's metadata file can override some Docker instructions. Ensure that you are familiar with how your Dockerfile interacts with {% data variables.product.prodname_actions %} to prevent any unexpected behavior.
+
+For reference information, see [AUTOTITLE](/actions/reference/dockerfile-support-for-github-actions).
+
 ## Defining the container image
 
 {% data reusables.actions.jobs.section-running-jobs-in-a-container-image %}

content/actions/reference/dockerfile-support-for-github-actions.md

@@ -15,14 +15,6 @@ type: reference
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
 
-## About Dockerfile instructions
-
-A `Dockerfile` contains instructions and arguments that define the contents and startup behavior of a Docker container. For more information about the instructions Docker supports, see [Dockerfile reference](https://docs.docker.com/engine/reference/builder/) in the Docker documentation.
-
-## Dockerfile instructions and overrides
-
-Some Docker instructions interact with GitHub Actions, and an action's metadata file can override some Docker instructions. Ensure that you are familiar with how your Dockerfile interacts with {% data variables.product.prodname_actions %} to prevent any unexpected behavior.
-
 ### USER
 
 Docker actions must be run by the default Docker user (root). Do not use the `USER` instruction in your `Dockerfile`, because you won't be able to access the `GITHUB_WORKSPACE` directory. For more information, see [AUTOTITLE](/actions/reference/variables-reference#default-environment-variables) and [USER reference](https://docs.docker.com/engine/reference/builder/#user) in the Docker documentation.