Apply suggestions from code review

Co-authored-by: rita <[email protected]>
hashicorp · Jan 31, 2025 · 3ddaae6 · 3ddaae6
1 parent cf46ce6
commit 3ddaae6
Show file tree

Hide file tree

Showing 15 changed files with 16 additions and 18 deletions.
diff --git a/website/content/docs/commands/build.mdx b/website/content/docs/commands/build.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  The `packer build` command runs all the builds within a template to generate a set of artifacts and outputs the artifacts at the end of the build.
+  The `packer build` command builds all of the artifacts defined in a template. Builds can run in parallel or sequentially.
 page_title: packer build - Commands
 ---
 

diff --git a/website/content/docs/commands/console.mdx b/website/content/docs/commands/console.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  The `packer console` command starts an interactove console so that you can experiment with Packer variable interpolations.
+  The `packer console` command starts an interactive console, letting you experiment with Packer variable interpolations.
 page_title: packer console command reference
 ---
 

diff --git a/website/content/docs/commands/fix.mdx b/website/content/docs/commands/fix.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  The `packer fix` command updates backward incompatible parts of a template so that you can use it with the latest version of Packer. 
+  The `packer fix` command updates backward incompatible templates for the running version of Packer. 
 page_title: packer fix command reference
 ---
 

diff --git a/website/content/docs/commands/hcl2_upgrade.mdx b/website/content/docs/commands/hcl2_upgrade.mdx
@@ -1,7 +1,7 @@
 ---
 description: |
   The `packer hcl2_upgrade` Packer command transpiles a JSON
-  configuration template to HCL2 so that you can transition to HCL templates.
+  configuration template into HCL2 so you can transition to HCL templates.
 page_title: packer hcl2_upgrade command reference
 ---
 

diff --git a/website/content/docs/commands/init.mdx b/website/content/docs/commands/init.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-    The `packer init` command downloads and installs one or more plugin binaries specified in a Packer template written in HCL so that you can build artifacts.
+    The `packer init` command downloads and installs the plugins specified in a Packer template.
 page_title: packer init command reference
 ---
 

diff --git a/website/content/docs/commands/inspect.mdx b/website/content/docs/commands/inspect.mdx
@@ -1,6 +1,6 @@
 ---
 description: >
-  The `packer inspect` command outputs the components defined in a template so that you can learn about a template manually reviewing the HCL. 
+  The `packer inspect` command outputs the variables, builders, and provisioners a template uses so you can review the template without reading the HCL.
 page_title: packer inspect command reference
 ---
 

diff --git a/website/content/docs/commands/plugins/install.mdx b/website/content/docs/commands/plugins/install.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  The `packer plugins install` command downloads and installs Packer plugin binaries without a Packer template so you can manually install plugins.
+  The `packer plugins install` command manually downloads and installs Packer plugins without having to update and initialize a build template. 
 page_title: packer plugins install command reference
 ---
 

diff --git a/website/content/docs/commands/plugins/required.mdx b/website/content/docs/commands/plugins/required.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  The `packer plugins required` command lists all plugins required in a Packer configuration as well as the installed binaries that match the constraint.
+  The `packer plugins required` command lists all of the plugins required by a Packer configuration and any installed binaries that satisfy the requirements.
 page_title: packer plugins required command reference
 ---
 

diff --git a/website/content/docs/commands/validate.mdx b/website/content/docs/commands/validate.mdx
@@ -1,7 +1,7 @@
 ---
 description: |
-  The `packer validate` Packer command validates the syntax and
-  configuration in a Packer template to help you prevent coding errors.
+  The `packer validate` command validates the syntax and
+  configuration in a Packer template, helping you prevent errors.
 page_title: packer validate command reference
 ---
 

diff --git a/website/content/docs/communicators/winrm.mdx b/website/content/docs/communicators/winrm.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  The `winrm` communication establishes a WinRM connection so that Packer can perform actions, such as upload files and execute scripts, on the machine it creates. 
+  The `winrm` communicator establishes a WinRM connection, letting Packer upload files or execute scripts on the machine it creates. 
 page_title: Establish a WinRM Connection
 ---
 

diff --git a/website/content/docs/configure.mdx b/website/content/docs/configure.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  Learn how to configure Packer's global behaviors using environment variables so that you can customize Packer operations to meet your needs.
+  Learn how to configure Packer's global behavior using environment variables.
 page_title: Configure Packer
 ---
 

diff --git a/website/content/docs/post-processors/artifice.mdx b/website/content/docs/post-processors/artifice.mdx
@@ -1,6 +1,6 @@
 ---
 description: >
-  The `artifice` post-processor overrides the artifact list from an upstream builder or post-processor. Use the `artifice` post-processor to build artifacts inside a Packer builder.
+  The `artifice` post-processor overrides the artifact list from an upstream builder or post-processor. Use it to build artifacts inside a Packer builder, such as starting an EC2 instance to build a Docker container, but only keep the Docker container's artifacts.
 page_title: artifice post-processor reference
 ---
 

diff --git a/website/content/docs/post-processors/compress.mdx b/website/content/docs/post-processors/compress.mdx
@@ -1,7 +1,6 @@
 ---
 description: |
-  The `compress` post-processor compresses an artifact that contains files, such as files from
-  VMware or VirtualBox, into a single archive.
+  The `compress` post-processor compresses an artifact that contains multiple files, such as VMware of VirtualBox builds, into a single archive.
 page_title: compress post-processor reference
 ---
 

diff --git a/website/content/docs/post-processors/manifest.mdx b/website/content/docs/post-processors/manifest.mdx
@@ -1,7 +1,6 @@
 ---
 description: >
-  The `manifest` post-processor writes a JSON file with the build artifacts and
-  IDs from a Packer run so that you can track output artifacts.
+  The `manifest` post-processor creates a JSON file that contains data about a Packer build's artifacts, letting you track a run's outputs.
 page_title: manifest post-processor reference
 ---
 

diff --git a/website/content/docs/post-processors/shell-local.mdx b/website/content/docs/post-processors/shell-local.mdx
@@ -1,6 +1,6 @@
 ---
 description: |
-  The `shell-local` post-processor starts a local shell so that you can automate post-build actions after Packer builds artifacts.
+  The `shell-local` post-processor starts a local shell, letting you automate post-build actions after Packer builds your artifacts.
 page_title: shell-local post-processor reference
 ---