EDI-ify "Using environments for deployment" (#56595)

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

Author: sabrowning1

content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/using-environments-for-deployment.md renamed to content/actions/concepts/workflows-and-actions/deployment-environments.md

@@ -1,27 +1,18 @@
 ---
-title: Using environments for deployment
-shortTitle: Environments
-intro: Specify a deployment environment in your workflow.
+title: Deployment environments
+intro: 'You can create and deploy to different environments.'
 versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
-redirect_from:
-  - /actions/using-jobs/using-environments-for-jobs
-  - /actions/using-jobs/using-environments-for-deployment
-  - /actions/writing-workflows/choosing-what-your-workflow-does/using-environments-for-deployment
+type: overview
+topics:
+  - Actions
+  - Workflows
 ---
- 
-{% data reusables.actions.enterprise-github-hosted-runners %}
-
-## About environments
 
 {% data reusables.actions.about-environments %}
 
 Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. The job can access the environment's secrets only after the job is sent to a runner.
 
 When a workflow references an environment, the environment will appear in the repository's deployments. For more information about viewing current and previous deployments, see [AUTOTITLE](/actions/deployment/managing-your-deployments/viewing-deployment-history).
-
-## Using an environment in a workflow
-
-{% data reusables.actions.environment-example %}

content/actions/concepts/workflows-and-actions/index.md

@@ -13,6 +13,7 @@ children:
   - /about-custom-actions
   - /contexts
   - /expressions
+  - /deployment-environments
   - /dependency-caching
   - /about-monitoring-workflows
   - /notifications-for-workflow-runs

content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/deploying-to-a-specific-environment.md

@@ -0,0 +1,44 @@
+---
+title: Deploying to a specific environment
+shortTitle: Deploy to environment
+intro: Specify a deployment environment in your workflow.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+redirect_from:
+  - /actions/using-jobs/using-environments-for-jobs
+  - /actions/using-jobs/using-environments-for-deployment
+  - /actions/writing-workflows/choosing-what-your-workflow-does/using-environments-for-deployment
+  - /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/using-environments-for-deployment
+---
+
+## Prerequisites
+
+You need to create an environment before you can use it in a workflow. See [AUTOTITLE](/actions/how-tos/managing-workflow-runs-and-deployments/managing-deployments/managing-environments-for-deployment#creating-an-environment).
+
+## Using an environment in a workflow
+
+1. Open the workflow file you want to edit.
+1. Use the following syntax to add a [`jobs.<job_id>.environment`](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idenvironment) key to your workflow:
+
+    ```yaml copy
+    jobs:
+      JOB-ID:
+        environment: ENVIRONMENT-NAME
+    ```
+
+    The chosen job will now be subject to any rules configured for the specified environment.
+1. Optionally, specify a deployment URL for the environment using the following syntax:
+
+    ```yaml copy
+    jobs:
+      JOB-ID:
+        environment: ENVIRONMENT-NAME
+        url: URL
+    ```
+
+    The specified URL will appear:
+    * On the deployments page for the repository
+    * In the visualization graph for the workflow run
+    * (If a pull request triggers the workflow) As a "View deployment" button in the pull request timeline

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

@@ -18,7 +18,7 @@ children:
   - /store-information-in-variables
   - /passing-information-between-jobs
   - /setting-a-default-shell-and-working-directory
-  - /using-environments-for-deployment
+  - /deploying-to-a-specific-environment
   - /control-the-concurrency-of-workflows-and-jobs
   - /running-variations-of-jobs-in-a-workflow
   - /storing-and-sharing-data-from-a-workflow