Merge pull request hashicorp#13286 from hashicorp/docs/packer-seo-fy2025q4

Docs/packer seo fy2025q4

Author: trujillo-adam

website/content/docs/builders/community-supported.mdx

@@ -1,14 +1,22 @@
 ---
 description: |
-  Community-maintained builders are not part of the core Packer binary, but
-  can run alongside Packer with minimal extra effort.
-page_title: Community - Builders
+  Community-supported builders are developed and maintained by third-parties and not HashiCorp. Use them with Packer to extend Packer functionality.
+page_title: Community-supported builders
 ---
 
-# Community Builders
+# Community-supported builders
 
 The following builders are developed and maintained by various members of the
 Packer community, not by HashiCorp. For more information on how to use community
-builders, see our docs on [extending Packer](/packer/docs/plugins/creation).
+builders, refer to our docs on [extending Packer](/packer/docs/plugins/creation).
 
-@include 'builders/community_builders.mdx'
+- ARM builders
+
+  - [packer-plugin-arm-image](https://github.com/solo-io/packer-plugin-arm-image): Lets you extend onto existing system images.
+  - [packer-builder-arm](https://github.com/mkaczanowski/packer-builder-arm): Lets you extend or build new images with a variety of options, such as custom partition tables.
+
+- [Exoscale builder](https://github.com/exoscale/packer-plugin-exoscale) - Creates Exoscale custom templates based on a compute instance snapshot.
+
+- [Citrix XenServer/Citrix Hypervisor](https://github.com/xenserver/packer-builder-xenserver) - Plugin for creating [Citrix XenServer/Citrix Hypervisor](https://xenserver.org/) images from an ISO image or from an existing template.
+
+- [XCP-NG/Citrix XenServer/Citrix Hypervisor/Updated Fork](https://github.com/ddelnano/packer-plugin-xenserver) - Plugin for creating [XCP-NG/Citrix XenServer/Citrix Hypervisor](https://xcp-ng.org/) images from an ISO image or from an existing template. This is a fork of the orginal and reccomended by the developers of XCP-NG.

website/content/docs/builders/custom.mdx

@@ -1,23 +1,18 @@
 ---
 description: |
-  The file Packer builder is not really a builder, it just creates an artifact
-  from a file. It can be used to debug post-processors without incurring high
-  wait times.
-page_title: File - Builders
+  The `file` builder creates an artifact from a file. Use the `file` builder to debug post-processors without incurring long wait times.
+page_title: file builder reference
 ---
 
 <BadgesHeader>
   <PluginBadge type="official" />
 </BadgesHeader>
 
-# File Builder
+# `file` builder
 
-Type: `file`
-Artifact BuilderId: `packer.file`
+The `file` builder creates an artifact from a file. You can use it to debug post-processors without incurring long wait times.
 
-The `file` Packer builder is not really a builder, it just creates an artifact
-from a file. It can be used to debug post-processors without incurring high
-wait times.
+Artifact `BuilderId`: `packer.file`
 
 ## Basic Example
 
@@ -60,12 +55,12 @@ described.
 
 Any [communicator](/packer/docs/templates/legacy_json_templates/communicator) defined is ignored.
 
-### Required:
+### Required
 
 - `target` (string) - The path for the artifact file that will be created. If
   the path contains directories that don't exist, Packer will create them, too.
 
-### Optional:
+### Optional
 
 You can only define one of `source` or `content`. If none of them is defined
 the artifact will be empty.

website/content/docs/builders/file.mdx

@@ -1,21 +1,20 @@
 ---
 description: |
-  Builders are responsible for creating machines and generating images from them
-  for various platforms.
-page_title: Builders
+  Builders create machines and generate images from them for various platforms. Learn about the types of builders you can use in your Packer templates.
+page_title: Builders overview
 ---
 
-# Builders
+# Builders overview
 
-Builders create machines and generate images from those machines for various platforms. Packer also has some builders that perform helper tasks, like running provisioners.
+Builders create machines and generate images from those machines for various platforms. Some builders in Packer perform helper tasks, such as running provisioners.
 
 Packer has the following types of builders:
 
-- [Plugin](/packer/plugins): Each plugin has its own associated set of builders. For example, there are separate builders for EC2, VMware, VirtualBox, etc.
-- [File](/packer/docs/builders/file): The `file` builder creates an artifact from a file.
-- [Null](/packer/docs/builders/null): The `null` builder sets up an SSH connection and runs the provisioners.
+- [Plugins](/packer/plugins): Plugins that you install have their own associated set of builders. For example, EC2, VMware, and VirtualBox use their own separate sets of builders.
+- [`file`](/packer/docs/builders/file): The `file` builder creates an artifact from a file.
+- [`null`](/packer/docs/builders/null): The `null` builder sets up an SSH connection and runs the provisioners.
 - [Custom](/packer/docs/plugins/creation/custom-builders): You can write new builders for new or existing platforms.
-- [Community-Supported](/packer/docs/builders/community-supported): The Packer community develops and maintains builders for several additional platforms.
+- [Community-supported](/packer/docs/builders/community-supported): The Packer community develops and maintains builders for several additional platforms.
 
 Refer to the [`source`](/packer/docs/templates/hcl_templates/blocks/source) block documentation to learn more about configuring builders in the Packer templating language.
 

website/content/docs/builders/index.mdx

@@ -1,24 +1,16 @@
 ---
 description: |
-  The null Packer builder is not really a builder, it just sets up an SSH
-  connection and runs the provisioners. It can be used to debug provisioners
-  without incurring high wait times. It does not create any kind of image or
-  artifact.
-page_title: Null - Builders
+  The `null` builder creates an SSH connection and runs provisioners. Use the `null` builder to debug provisioners without incurring long wait times. 
+page_title: null builder reference
 ---
 
 <BadgesHeader>
   <PluginBadge type="official" />
 </BadgesHeader>
 
-# Null Builder
+# `null` builder
 
-Type: `null`
-
-The `null` Packer builder is not really a builder, it just sets up an SSH
-connection and runs the provisioners. It can be used to debug provisioners
-without incurring high wait times. It does not create any kind of image or
-artifact.
+The `null` builder sets up an SSH connection and runs provisioners. You can use it to debug provisioners without incurring long wait times. It does not create a images or artifacts.
 
 ## Basic Example
 

website/content/docs/builders/null.mdx

@@ -1,13 +1,10 @@
 ---
 description: |
-  The `packer build` command takes a template and runs all the builds within it
-  in order to generate a set of artifacts. The various builds specified within a
-  template are executed in parallel, unless otherwise specified. And the
-  artifacts that are created will be outputted 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
 ---
 
-# `build` Command
+# `packer build` command reference
 
 The `packer build` command takes a template and runs all the builds within it
 in order to generate a set of artifacts. The various builds specified within a

website/content/docs/commands/build.mdx

@@ -1,11 +1,10 @@
 ---
 description: |
-  The `packer console` command allows you to experiment with Packer variable
-  interpolations.
-page_title: packer console - Commands
+  The `packer console` command starts an interactive console, letting you experiment with Packer variable interpolations.
+page_title: packer console command reference
 ---
 
-# `console` Command
+# `packer console` command reference
 
 The `packer console` command allows you to experiment with Packer variable
 interpolations. You may access variables in the Packer config you called the

website/content/docs/commands/console.mdx

@@ -1,21 +1,19 @@
 ---
 description: |
-  The `packer fix` command takes a template and finds backwards incompatible
-  parts of it and brings it up to date so it can be used with the latest version
-  of Packer. After you update to a new Packer release, you should run the fix
-  command to make sure your templates work with the new release.
-page_title: packer fix - Commands
+  The `packer fix` command updates backward incompatible templates for the running version of Packer. 
+page_title: packer fix command reference
 ---
 
-# `fix` Command
+# `packer fix` command reference
 
--> **Note** This command is not available on HCL2 templates yet, it will be added when we need to introduce the first 'fix'.
 
-The `packer fix` command takes a template and finds backwards incompatible
+The `packer fix` command takes a template and finds backward incompatible
 parts of it and brings it up to date so it can be used with the latest version
 of Packer. After you update to a new Packer release, you should run the fix
 command to make sure your templates work with the new release.
 
+-> **JSON template-only command**: You cannot use the `packer fix` command to update HCL2 templates.
+
 The fix command will output the changed template to standard out, so you should
 redirect standard out using standard OS-specific techniques if you want to save it
 to a file. For example, on Linux systems, you may want to do this:

website/content/docs/commands/fix.mdx

@@ -1,11 +1,10 @@
 ---
 description: |
-  The `packer fmt` Packer command is used to format HCL2
-  configuration files to a canonical format and style.
-page_title: packer fmt - Commands
+  The `packer fmt` Packer command formats HCL2 configuration files to a canonical format and style to help you prevent coding errors.
+page_title: packer fmt command reference
 ---
 
-# `fmt` Command
+# `packer fmt` command reference
 
 The `packer fmt` Packer command is used to format HCL2 configuration files to
 a canonical format and style. JSON files (.json) are not modified. This command

website/content/docs/commands/fmt.mdx

@@ -1,23 +1,20 @@
 ---
 description: |
-  The `packer hcl2_upgrade` Packer command is used to transpile a JSON
-  configuration template to its formatted HCL2 counterpart. The command will
-  return a zero exit status on success, and a non-zero exit status on failure.
-page_title: packer hcl2_upgrade - Commands
+  The `packer hcl2_upgrade` Packer command transpiles a JSON
+  configuration template into HCL2 so you can transition to HCL templates.
+page_title: packer hcl2_upgrade command reference
 ---
 
--> **Note:** This command is Beta, and currently being improved upon; do not
-hesitate [opening a new
-issue](https://github.com/hashicorp/packer/issues/new/choose) if you find
-something wrong.
+# `packer hcl2_upgrade` command reference
 
-# `hcl2_upgrade` Command
+The `packer hcl2_upgrade` Packer command transpiles a JSON
+configuration template to it's formatted HCL2 counterpart. The command
+returns a zero exit status on success and a non-zero exit status on failure.
 
-The `packer hcl2_upgrade` Packer command is used to transpile a JSON
-configuration template to it's formatted HCL2 counterpart. The command will
-return a zero exit status on success, and a non-zero exit status on failure.
+-> **This command is beta**. We do not recommend using beta functionality in production environments. To report an issue and provide feedback, [open a GitHub
+issue](https://github.com/hashicorp/packer/issues/new/choose).
 
-Example usage:
+## Usage
 
 ```shell-session
 $ packer hcl2_upgrade my-template.json