Rename runs

Author: rkoron007

content/terraform-docs-common/docs/cloud-docs/stacks/create.mdx

@@ -10,26 +10,32 @@ Stacks enable you to provision and coordinate your infrastructure lifecycle at s
 
 > **Hands-on**: Try out the [Deploy a Stack with HCP Terraform](/terraform/tutorials/cloud/stacks-deploy) tutorial to get started with Stacks quickly.
 
-This article explains how to create a Stack in HCP Terraform using component and deployment configuration files.
+Before creating a Stack in HCP Terraform, write a [component configuration file](/terraform/language/stacks/component/config) to define your Stack's infrastructure, and a [deployment configuration file](/terraform/language/stacks/deploy/config) to tell HCP Terraform how to deploy your Stack.
 
 ## Requirements
 
+<Note>
+
 Stacks are not available for users on legacy HCP Terraform team plans. Learn more about [migrating to current HCP Terraform plans](/terraform/cloud-docs/overview/migrate-teams-standard).
 
-To create a Stack in HCP Terraform, you must set up the following:
- must also be a member of a team in your organization with one of the following permissions:
-* [Organization-level **Manage all projects**](/terraform/cloud-docs/users-teams-organizations/permissions#manage-all-projects)
-* [Project-level **Maintain**](/terraform/cloud-docs/users-teams-organizations/permissions#maintain) or higher
+</Note>
+
+To create a Stack in HCP Terraform, you must be a member of a team in your organization with one of the following permissions:
+- [Organization-level **Manage all projects**](/terraform/cloud-docs/users-teams-organizations/permissions#manage-all-projects)
+- [Project-level **Maintain**](/terraform/cloud-docs/users-teams-organizations/permissions#maintain) or higher
 
 ## Create a Stack
 
-You can create a Stack 
+You can create a Stack using any of the following methods:
+- The [HCP Terraform API](/terraform/cloud-docs/api-docs/stacks)
+- The HCP Terraform UI
+- The Terraform CLI
 
-<!-- TODO: is this still true past GA? -->
+If you are creating a Stack in an organization for the first time, you must enable Stacks for your organization. Navigate to your organization’s **Settings** page, and in the **General** settings, check the box next to **Stacks**.
 
-If you are creating a Stack in an organization for the first time, you should first enable Stacks for your organization. Navigate to your organization’s **Settings** page, and in the **General** settings, check the box next to **Stacks** to enable them.
+### HCP Terraform workflow
 
-Stacks live alongside workspaces in a project. To create a new Stack in HCP Terraform, perform the following steps:
+Stacks live alongside workspaces in a project. To create a new Stack in HCP Terraform UI, perform the following steps:
 
 1. Sign in to [HCP Terraform](https://app.terraform.io), and select the organization that contains your Stack.
 1. In the navigation menu, click **Projects** under **Manage**.
@@ -47,6 +53,65 @@ Stacks live alongside workspaces in a project. To create a new Stack in HCP Terr
     * By default, HCP Terraform fetches your Stack's configuration after creating your Stack. To fetch your Stack configuration manually, uncheck **Fetch configuration after HCP Terraform creates stack.**
 1. Click **Create Stack**.
 
+### Terraform CLI workflow
+
+Stacks live alongside workspaces in an HCP Terraform project. To create a new Stack using the Terraform CLI, perform the following steps:
+
+1. Create an account or sign in to [HCP Terraform](https://app.terraform.io).
+1. Run `terraform login` to authenticate with HCP Terraform. Alternatively, you can manually configure credentials in the CLI config file or through environment variables. Refer to [CLI Configuration](/terraform/cli/config/config-file#environment-variable-credentials) for details.
+1. Run the `terraform stacks create` command, replacing the placeholders with your organization name, project name, and desired Stack name:
+
+```shell-session
+$ terraform stacks create -organization <ORGANIZATION_NAME> -project <PROJECT_NAME> -stack-name <STACK_NAME>
+```
+
+A Stack name must be unique within the project and can include letters, numbers, dashes (`-`), and underscores (`_`). We recommend using 90 characters or less for the name of your Stack.
+
+After running the command, you can view your new Stack in the HCP Terraform UI, or by running the `terraform stacks list` command:
+
+```shell-session
+$ terraform stacks list -organization <ORGANIZATION_NAME> -project <PROJECT_NAME>
+```
+
+After creating your Stack, you can push up your Stack component and deployment configuration files to create a new configuration version. Use the `terraform stacks configuration upload` command to manually upload your configuration files:
+
+```shell-session
+$ terraform stacks configuration upload -organization <ORGANIZATION_NAME> -project <PROJECT_NAME> -stack-name <STACK_NAME>
+```
+
+The Terraform CLI uploads the configuration files, and returns a new configuration version ID and sequence number:
+
+```shell-session
+Uploading stack configuration...
+
+Configuration for Stack (id: 'st-MLQLSJVrdtGazA4aU') was uploaded
+Configuration ID: stc-6fSRO81hOzTPKMM
+Sequence Number: 1
+
+See run at: <URL>
+```
+
+A Stack configuration version is a snapshot of all of the pieces that make up your Stack. Each configuration version creates a deployment run for every deployment of your Stack in order to implement the changes in that version. To learn more, refer to [Stack deployment runs](/terraform/cloud-docs/stacks/runs).
+
+After uploading your configuration, you can watch your Stack's configuration roll out using `terraform stacks configuration watch` to review a list of the deployment groups in your configuration:
+
+```shell-session
+$ terraform stacks configuration watch -organization <ORGANIZATION_NAME> -project <PROJECT_NAME>
+
+
+[Stack Id: st-MLQLSJVrdtGazA4aU]
+✓ Configuration: 'stc-6fSRO81hOzTPKMM'                    [Completed]    [11s]
+↻ Deployment Group: 'many_default'                        [Pending]      [58s]
+↻ Deployment Group: 'some_default'                        [Pending]      [58s]
+↻ Deployment Group: 'single_default'                      [Failed]       [6s]
+
+Press q to quit
+```
+
+You can continue to use the `terraform stacks` CLI commands to directly approve deployment runs, review configuration versions, and manage your Stack. To learn more, refer to the [`terraform stacks` commands](/terraform/cli/commands/stacks).
+
+Note that though you can create a Stack from the Terraform CLI, you cannot deploy a Stack locally. You can only deploy a Stack remotely in HCP Terraform, or by running your a Stack on a custom HCP Terraform agent. To learn more, refer to [Stack deployment runs](/terraform/cloud-docs/stacks/runs).
+
 ## Next steps
 
-After creating your Stack, you can continue to iterate on your configuration and [review configuration versions](/terraform/cloud-docs/stacks/deploy/configuration-versions) or learn how to [review your Stack’s deployment plans](/terraform/cloud-docs/stacks/deploy/plans).
+After creating your Stack, you can continue to iterate on your configuration and [review configuration versions](/terraform/cloud-docs/stacks/deploy/configuration-versions) or learn how to [review your Stack’s deployment runs](/terraform/cloud-docs/stacks/deploy/runs).

content/terraform-docs-common/docs/cloud-docs/stacks/deploy/plans.mdx renamed to content/terraform-docs-common/docs/cloud-docs/stacks/deploy/runs.mdx

@@ -4,11 +4,11 @@ description: Learn how to review deployment plans in HCP Terraform Stacks.
 tfc_only: true
 ---
 
-# Review deployment plans
+# Review deployment runs
 
-Deployment plans are a combination of an individual configuration version and one of your Stack's deployments. As in the traditional Terraform workflow, HCP Terraform creates plans every time a new configuration version introduces potential changes for a deployment.
+Deployment runs are a combination of an individual configuration version and one of your Stack's deployments. As in the traditional Terraform workflow, HCP Terraform creates runs every time a new configuration version introduces potential changes for a deployment.
 
-This guide explains how to review and approve deployment plans in HCP Terraform.
+This guide explains how to review and approve deployment runs in HCP Terraform.
 
 ## Requirements
 

content/terraform-docs-common/docs/cloud-docs/stacks/runs.mdx

@@ -5,7 +5,7 @@ description: |-
 tfc_only: true
 ---
 
-# Stack runs
+# Stack deployment runs
 
 HCP Terraform is the interface for keeping track of your Stack configuration over time and the corresponding deployments for each version of your configuration. Learn how HCP Terraform executes Terraform runs to keep Stack deployments up to date.