CLI List and HCP command docs refresh

website/content/docs/commands/hcp/connect.mdx

@@ -1,17 +1,29 @@
 ---
 layout: docs
-page_title: hcp connect - Command
+page_title: hcp connect - Vault CLI
 description: |-
-  Use "hcp connect" command to authenticate users and machines to HCP with explicit
+  Authenticate users and machines to HCP with explicit
   credentials or an HCP token and interactive browser login.
 ---
 
 # hcp connect
 
-The `hcp connect` command authenticates users and machines to HCP with explicit
-credentials or an HCP token and interactive browser login.
+`hcp connect` authenticates users or machines to HCP using either provided arguments or retrieved token through
+browser login. A successful authentication results in an HCP token and an HCP Vault address being
+locally cached.
 
-By default, the `hcp connect` command uses interactive authentication that requires
+<CodeBlockConfig hideClipboard>
+
+```shell-session
+$ vault hcp connect [options]
+$ vault hcp connect [-help | -h]
+```
+
+</CodeBlockConfig>
+
+## Description
+
+By default, `hcp connect` uses interactive authentication that requires
 users to log into the HashiCorp Cloud Platform with a browser.
 
 Non-interactive login requires a service principal credential that was
@@ -21,40 +33,60 @@ access to the requested organization, project, and HCP Vault Dedicated cluster.
 If authentication succeeds, the Vault CLI saves the returned HCP token and HCP
 Vault address in the local cache.
 
-## Examples
+### Limitations and warnings
 
-Connect to HCP interactively:
+- None
 
-```shell-session
-$ vault hcp connect
-The default web browser has been opened at <auth_url>. Please continue the login in the web browser.
-Success!
-```
+## Command arguments
+
+- None
+
+## Command options
+
+- None
 
-## Usage
+## Command flags
 
-The following flags are available in addition to the [standard set of
-flags](/vault/docs/commands) included on all commands.
+<br />
 
-### Command options
+@include 'cli/hcp/flags/client-id.mdx'
 
-- `-client-id` `(string: "")` - Client ID belonging to a service principal
-credential generated in the HCP Portal. **Required for non-interactive
-authentication**.
+<br />
+<hr />
+<br />
 
-- `-secret-id` `(string: "")` - Secret ID belonging to a service principal
-credential previously generated in the HCP Portal. **Required for
-non-interactive authentication**.
+@include 'cli/hcp/flags/secret-id.mdx'
 
-- `-organization-id` `(string: "")` - Optional ID of the desired HCP
-organization. If `organization-id` is empty and the user is associated with
-multiple HCP organizations, the CLI prompts the user to select from a list
-of available organizations.
+<br />
+<hr />
+<br />
 
-- `-project-id` `(string: "")` - Optional ID of the desired HCP project. If
-  `project-id` is empty and the user is associated with more than one HCP
-   project, the CLI prompts the user to select from a list of available projects.
+@include 'cli/hcp/flags/organization-id.mdx'
 
-- `-cluster-id` `(string: "")` - Optional ID of the desired HCP Vault Dedicated cluster.
-If `cluster-id` is empty and the user is associated with multiple HCP clusters,
-the CLI prompts the user to select from a list of available clusters.
+<br />
+<hr />
+<br />
+
+@include 'cli/hcp/flags/project-id.mdx'
+
+<br />
+<hr />
+<br />
+
+@include 'cli/hcp/flags/cluster-id.mdx'
+
+## Standard flags
+
+<br />
+
+@include 'cli/standard-settings/all-standard-flags.mdx'
+
+## Examples
+
+Connect to HCP interactively:
+
+```shell-session
+$ vault hcp connect
+The default web browser has been opened at <auth_url>. Please continue the login in the web browser.
+Success!
+```

website/content/docs/commands/hcp/disconnect.mdx

@@ -1,13 +1,48 @@
 ---
 layout: docs
-page_title: hcp disconnect - Command
+page_title: hcp disconnect - Vault CLI
 description: |-
-  Use "hcp disconnect" command invalidates live sessions to a HCP Vault Dedicated cluster.
+  Invalidate live sessions to a HCP Vault Dedicated cluster.
 ---
 
-# hcp disconnect
+# `hcp disconnect`
 
-The `hcp disconnect` command invalidates live sessions to a HCP Vault Dedicated cluster.
+`hcp disconnect` invalidates live sessions to a HCP Vault Dedicated cluster.
+
+<CodeBlockConfig hideClipboard>
+
+```shell-session
+$ vault hcp disconnect [options]
+$ vault hcp disconnect [-help | -h]
+```
+
+</CodeBlockConfig>
+
+## Description
+
+`hcp disconnect` invalidates live sessions to a HCP Vault Dedicated cluster.
+
+### Limitations and warnings
+
+- None
+
+## Command arguments
+
+- None
+
+## Command options
+
+- None
+
+## Command flags
+
+- None
+
+## Standard flags
+
+<br />
+
+@include 'cli/standard-settings/all-standard-flags.mdx'
 
 ## Examples
 
@@ -16,8 +51,3 @@ Disconnect from HCP:
 ```shell-session
 $ vault hcp disconnect
 ```
-
-## Usage
-
-All [standard set of
-flags](/vault/docs/commands) are included.

website/content/docs/commands/list.mdx

@@ -1,25 +1,54 @@
 ---
 layout: docs
-page_title: list - Command
+page_title: list - Vault CLI
 description: |-
-  The "list" command lists data from Vault at the given path. This can be used
+  List data from Vault at the given path. This can be used
   to list keys in a, given secrets engine.
 ---
 
 # list
 
-The `list` command lists data from Vault at the given path (wrapper command for
+List data from Vault at the given path. This can be used
+to list keys in a, given secrets engine.
+
+<CodeBlockConfig hideClipboard>
+
+```shell-session
+$ vault list [options] PATH
+$ vault list [-help | -h]
+```
+
+</CodeBlockConfig>
+
+## Description
+
+`list` lists data from Vault at the given path (wrapper command for
 HTTP LIST). This can be used to list keys in a given secrets engine.
 
+### Limitations and warnings
+
+- None
+
+## Command arguments
+
+<br />
+
+@include 'cli/list/args/path.mdx'
+
+## Command flags
+
+- None
+
+## Standard flags
+
+<br />
+
+@include 'cli/standard-settings/all-standard-flags.mdx'
+
 ## Examples
 
 List available entities by their identifiers:
 
 ```shell-session
 $ vault list identity/entity/id
 ```
-
-## Usage
-
-There are no flags beyond the [standard set of flags](/vault/docs/commands)
-included on all commands.

website/content/partials/cli/hcp/flags/client-id.mdx

@@ -0,0 +1,9 @@
+<a id="hcp-connect-flag-client-id" />
+
+** `-client-id (string : "")` **
+
+Client ID belonging to a service principal
+credential generated in the HCP Portal. **Required for non-interactive
+authentication**.
+
+**Example**: `-client-id "sp-739987@d79db23f-54f6-41c1-bc48-f870542c0ae1"`

website/content/partials/cli/hcp/flags/cluster-id.mdx

@@ -0,0 +1,9 @@
+<a id="hcp-connect-flag-cluster-id" />
+
+** `-project-id (string : "")` **
+
+Optional ID of the desired HCP Vault Dedicated cluster.
+If `cluster-id` is empty and the user is associated with multiple HCP clusters,
+the CLI prompts the user to select from a list of available clusters.
+
+**Example**: `-cluster-id "cluster-name"`

website/content/partials/cli/hcp/flags/organization-id.mdx

@@ -0,0 +1,10 @@
+<a id="hcp-connect-flag-organization-id" />
+
+** `-organization-id (string : "")` **
+
+Optional ID of the desired HCP
+organization. If `organization-id` is empty and the user is associated with
+multiple HCP organizations, the CLI prompts the user to select from a list
+of available organizations.
+
+**Example**: `-organization-id "80wdc133-3eb3-4d57-a244-1rt43b67nui9"`

website/content/partials/cli/hcp/flags/project-id.mdx

@@ -0,0 +1,9 @@
+<a id="hcp-connect-flag-project-id" />
+
+** `-project-id (string : "")` **
+
+Optional ID of the desired HCP project. If
+`project-id` is empty and the user is associated with more than one HCP
+project, the CLI prompts the user to select from a list of available projects.
+
+**Example**: `-project-id "d79cs87e-54f6-41w1-bc48-f870542c0av1"`

website/content/partials/cli/hcp/flags/secret-id.mdx

@@ -0,0 +1,9 @@
+<a id="hcp-connect-flag-secret-id" />
+
+** `-secret-id (string "")` **
+
+Secret ID belonging to a service principal
+credential previously generated in the HCP Portal. **Required for
+non-interactive authentication**.
+
+**Example**: `-secret-id "secret-id-value"`

website/content/partials/cli/list/args/path.mdx

@@ -0,0 +1,7 @@
+<a id="list-arg-path" />
+
+**`path (string : <required>)`**
+
+The internal path in Vault that lists data.
+
+**Example**: `"secret/my-app/"`

website/data/docs-nav-data.json

@@ -644,7 +644,7 @@
           {
             "title": "<code>generate-config</code>",
             "path": "commands/agent/generate-config"
-          }    
+          }
         ]
       },
       {
@@ -712,10 +712,6 @@
       {
         "title": "<code>hcp</code>",
         "routes": [
-          {
-            "title": "Overview",
-            "path": "commands/hcp"
-          },
           {
             "title": "<code>connect</code>",
             "path": "commands/hcp/connect"
@@ -1950,7 +1946,6 @@
                 "path": "auth/saml/troubleshoot-adfs/adfs-event-320"
               }
             ]
-
           }
         ]
       },