Apply suggestions from code review

Co-authored-by: Erin Donehoo <105813956+edonehoo@users.noreply.github.com>

Author: dlabaj

packages/documentation-site/patternfly-docs/content/developer-guides/patternfly-cli.md

@@ -6,58 +6,55 @@ section: developer-guides
 
 The [PatternFly CLI](https://github.com/patternfly/patternfly-cli) is a command-line tool for scaffolding projects, performing code modifications, and running project-related tasks. It aims to streamline development workflows and improve productivity. The published package is [`@patternfly/patternfly-cli` on npm](https://www.npmjs.com/package/@patternfly/patternfly-cli).
 
-## Features
+## What does the PatternFly CLI help with?
 
 - **Project scaffolding:** Quickly set up new PatternFly based projects for development and prototyping via predefined templates.
 - **Code modifications:** Automate repetitive code changes to help accelerate PatternFly version upgrades.
 - **Task runner:** Execute project-related tasks efficiently, such as source code management and task running.
 
 
-## How do I setup PatternFly CLI?
+## How do I set up PatternFly CLI?
 
 ### Prerequisites
-Prerequistes can be found below. For macOS, WSL, and Linux it is recommended that you use [install script](#install-script-macos-and-linux), it covers the items below (you may still need administrator access for system packages). Window based system you will need to install the following yourself before using the CLI:
+There are a few key prerequisites to meet before using PatternFly CLI. For macOS, WSL, and Linux, we recommended using [install script](#install-script-macos-and-linux) to address the following prerequisites (you might still need administrator access for system packages). For a Windows-based system, you will need to install the following items manually:
 
-- **[Node.js and npm](https://nodejs.org/)** (supported versions **20–24**) — also see [npm](https://www.npmjs.com/).
-- **[Corepack](https://nodejs.org/api/corepack.html)** — included with Node.js; enable with `corepack enable` after installing npm.
+- **[Node.js](https://nodejs.org/)** (Supported versions: 20–24) and **[npm](https://www.npmjs.com/)**
+- **[Corepack](https://nodejs.org/api/corepack.html)** (Included with Node.js and enabled via `corepack enable` after installing npm)
 - **[GitHub CLI](https://cli.github.com/)** (`gh`)
 
 ## Installation
 
 ### Install script (macOS and Linux)
 
-You can pipe the repository install script into `bash`. It installs Node.js with [nvm](https://github.com/nvm-sh/nvm) when `node` is not available, enables Corepack, installs GitHub CLI when it is missing, then installs the CLI globally from npm:
+You can pipe the repository install script into `bash`. This installs Node.js with [nvm](https://github.com/nvm-sh/nvm) when `node` is not available, enables Corepack, installs GitHub CLI when it is missing, and installs the CLI globally from npm:
 
 ```sh
 curl -fsSL https://raw.githubusercontent.com/patternfly/patternfly-cli/main/scripts/install.sh | bash
 ```
 
-The script may prompt for `sudo` when your system package manager installs GitHub CLI.
+The script might prompt you to include `sudo` when your system package manager installs GitHub CLI.
 
-### Windows Install
+### Windows
 
  After installing the [prerequisites](#prerequisites) on your machine, install the published package globally:
 
 ```sh
 npm install -g @patternfly/patternfly-cli
 ```
 
-## Usage
+## How do I use PatternFly CLI?
 
-After installation, you can verify the latest version of the CLI has been installed by running the following in the termianl:
+After installation, you can verify the latest version of the CLI has been installed by running the following terminal command:
 
-```sh
-patternfly-cli -v
-```
 
 ### Available CLI commands
-
+Once the PatternFly CLI is installed, you can run the following commands via `patternfly-cli [command]`:
 | Command | Usage |
 | --- | --- |
 | `create` | Create a new project from the available templates. |
 | `list` | List all available templates (built-in and optional custom). |
 | `update` | Update your project to a newer version. |
-| `cli-upgrade` | Upgrade the globally installed CLI to the latest npm release. It runs `npm install -g @patternfly/patternfly-cli@latest`; use your package manager’s equivalent if you did not install with npm. |
+| `cli-upgrade` | Upgrade the globally installed CLI to the latest npm release. It runs `npm install -g @patternfly/patternfly-cli@latest`—use your package manager’s equivalent if you did not install with npm. |
 | `init` | Initialize a git repository and optionally create a GitHub repository. |
 | `save` | Commit and push changes to the current branch. |
 | `load` | Pull the latest updates from GitHub. |
@@ -67,21 +64,21 @@ For the most up-to-date flags and behavior guidance, refer to [PatternFly CLI RE
 
 ### Custom templates
 
-You can add your own templates in addition to the built-in ones by passing a JSON file with `--template-file` (or `-t`). Custom templates are merged with the built-in list; if a custom template has the same `name` as a built-in one, the custom definition is used.
+In addition to the built-in templates, you can add your own templates by passing a JSON file with `--template-file` (or `-t`). Custom templates are merged with the built-in list—if a custom template has the same `name` as a built-in template, the custom definition is used.
 
-**Create with custom templates:**
+**Create a project based on custom templates:**
 
 ```sh
 patternfly-cli create my-app --template-file ./my-templates.json
 ```
 
-**List templates including custom file:**
+**List templates included in custom file:**
 
 ```sh
 patternfly-cli list --template-file ./my-templates.json
 ```
 
-**JSON format** (array of template objects, same shape as the built-in templates):
+**JSON format** (Array of template objects, shown in the same shape as the built-in templates):
 
 ```json
 [
@@ -95,8 +92,8 @@ patternfly-cli list --template-file ./my-templates.json
 ]
 ```
 
-- **`name`** (required): Template identifier.
-- **`description`** (required): Short description shown in prompts and `list`.
-- **`repo`** (required): Git clone URL.
-- **`options`** (optional): Array of extra arguments for `git clone` (e.g. `["--single-branch", "--branch", "main"]`).
-- **`packageManager`** (optional): `npm`, `yarn`, or `pnpm`; defaults to `npm` if omitted.
+- **`name`** (required): Template identifier
+- **`description`** (required): Short description shown in prompts and `list`
+- **`repo`** (required): Git clone URL
+- **`options`** (optional): Array of extra arguments for `git clone` (such as `["--single-branch", "--branch", "main"]`)
+- **`packageManager`** (optional): `npm`, `yarn`, or `pnpm`; defaults to `npm` if omitted