Merge pull request #57806 from mletalie/OSDOCS-5591

Example command punctuation lacks consistency

Author: bergerhoffer

modules/rosa-common-commands.adoc

@@ -2,11 +2,10 @@
 // Module included in the following assemblies:
 //
 // * cli_reference/rosa_cli/rosa-manage-objects-cli.adoc
-
+:_content-type: REFERENCE
 [id="rosa-common-commands_{context}"]
 = Common commands and arguments
 
-
 These common commands and arguments are available for the `rosa` CLI.
 
 [id="rosa-debug_{context}"]
@@ -26,13 +25,13 @@ $ rosa create cluster --cluster=<cluster_name> --debug
 Displays general help information for the `rosa` CLI and a list of available commands. This option can also be used as an argument to display help information for a parent command, such as `version` or `create`.
 
 .Examples
-Displays general help for the `rosa` CLI:
+Displays general help for the `rosa` CLI.
 [source,terminal]
 ----
 $ rosa --help
 ----
 
-Displays general help for `version`:
+Displays general help for `version`.
 [source,terminal]
 ----
 $ rosa version --help

modules/rosa-create-objects.adoc

@@ -2,7 +2,7 @@
 // Module included in the following assemblies:
 //
 // * cli_reference/rosa_cli/rosa-manage-objects-cli.adoc
-
+:_content-type: REFERENCE
 [id="rosa-create-objects_{context}"]
 = Create objects
 
@@ -94,7 +94,7 @@ $ rosa create admin --cluster=<cluster_name> | <cluster_id>
 |===
 
 .Example
-Create a cluster administrator that can log in to a cluster named `mycluster`:
+Create a cluster administrator that can log in to a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -208,21 +208,21 @@ When using `--private-link`, the `--subnet-ids` argument is required and only on
 |===
 
 .Examples
-Create a cluster named `mycluster`:
+Create a cluster named `mycluster`.
 
 [source,terminal]
 ----
 $ rosa create cluster --cluster=mycluster
 ----
 
-Create a cluster with a specific AWS region:
+Create a cluster with a specific AWS region.
 
 [source,terminal]
 ----
 $ rosa create cluster --cluster=mycluster --region=us-east-2
 ----
 
-Create a cluster with autoscaling enabled on the default worker machine pool:
+Create a cluster with autoscaling enabled on the default worker machine pool.
 
 [source,terminal]
 ----
@@ -373,14 +373,14 @@ $ rosa create idp --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Examples
-Add a GitHub identity provider to a cluster named `mycluster`:
+Add a GitHub identity provider to a cluster named `mycluster`.
 
 [source,terminal]
 ----
 $ rosa create idp --type=github --cluster=mycluster
 ----
 
-Add an identity provider following interactive prompts:
+Add an identity provider following interactive prompts.
 
 [source,terminal]
 ----
@@ -435,21 +435,21 @@ $ rosa create ingress --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Examples
-Add an internal ingress to a cluster named `mycluster`:
+Add an internal ingress to a cluster named `mycluster`.
 
 [source,terminal]
 ----
 $ rosa create ingress --private --cluster=mycluster
 ----
 
-Add a public ingress to a cluster named `mycluster`:
+Add a public ingress to a cluster named `mycluster`.
 
 [source,terminal]
 ----
 $ rosa create ingress --cluster=mycluster
 ----
 
-Add an ingress with a route selector label match:s
+Add an ingress with a route selector label match.
 
 [source,terminal]
 ----
@@ -522,28 +522,28 @@ $ rosa create machinepool --cluster=<cluster_name> | <cluster_id> --replicas=<nu
 |===
 
 .Examples
-Interactively add a machine pool to a cluster named `mycluster`:
+Interactively add a machine pool to a cluster named `mycluster`.
 
 [source,terminal]
 ----
 $ rosa create machinepool --cluster=mycluster --interactive
 ----
 
-Add a machine pool that is named `mp-1` to a cluster with autoscaling enabled:
+Add a machine pool that is named `mp-1` to a cluster with autoscaling enabled.
 
 [source,terminal]
 ----
 $ rosa create machinepool --cluster=mycluster --enable-autoscaling --min-replicas=2 --max-replicas=5 --name=mp-1
 ----
 
-Add a machine pool that is named `mp-1` with 3 replicas of `m5.xlarge` to a cluster:
+Add a machine pool that is named `mp-1` with 3 replicas of `m5.xlarge` to a cluster.
 
 [source,terminal]
 ----
 $ rosa create machinepool --cluster=mycluster --replicas=3 --instance-type=m5.xlarge --name=mp-1
 ----
 
-Add a machine pool with labels to a cluster:
+Add a machine pool with labels to a cluster.
 
 [source,terminal]
 ----
@@ -566,7 +566,7 @@ $ rosa create ocm-role [flags]
 |===
 |Option |Definition
 
-|--admin                         
+|--admin
 |Enable admin capabilities for the role.
 
 |--debug

modules/rosa-list-objects.adoc

@@ -1,7 +1,7 @@
 // Module included in the following assemblies:
 //
 // * cli_reference/rosa_cli/rosa-manage-objects-cli.adoc
-
+:_content-type: REFERENCE
 [id="rosa-list-objects_{context}"]
 = List and describe objects
 
@@ -122,7 +122,7 @@ $ rosa list idps --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Example
-List all identity providers (IDPs) for a cluster named `mycluster`:
+List all identity providers (IDPs) for a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -168,7 +168,7 @@ $ rosa list ingresses --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Example
-List all API and ingress endpoints for a cluster named `mycluster`:
+List all API and ingress endpoints for a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -204,7 +204,7 @@ $ rosa list instance-types [arguments]
 |===
 
 .Example
-List all instance types:
+List all instance types.
 
 [source,terminal]
 ----
@@ -250,7 +250,7 @@ $ rosa list machinepools --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Example
-List all of the machine pools on a cluster named `mycluster`:
+List all of the machine pools on a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -296,7 +296,7 @@ $ rosa list regions [arguments]
 |===
 
 .Example
-List all of the available regions:
+List all of the available regions.
 
 [source,terminal]
 ----
@@ -342,7 +342,7 @@ $ rosa list upgrades --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Example
-List all of the available upgrades for a cluster named `mycluster`:
+List all of the available upgrades for a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -387,7 +387,7 @@ $ rosa list users --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Example
-List all of the cluster administrators and dedicated administrators for a cluster named `mycluster`:
+List all of the cluster administrators and dedicated administrators for a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -424,7 +424,7 @@ $ rosa list versions [arguments]
 |===
 
 .Example
-List all of the OpenShift Container Platform versions:
+List all of the OpenShift Container Platform versions.
 
 [source,terminal]
 ----
@@ -470,7 +470,7 @@ $ rosa describe admin --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Example
-Describe the `cluster-admin` user for a cluster named `mycluster`:
+Describe the `cluster-admin` user for a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -507,7 +507,7 @@ $ rosa describe addon <addon_id> | <addon_name> [arguments]
 |===
 
 .Example
-Describe an add-on named `dbaas-operator`:
+Describe an add-on named `dbaas-operator`.
 
 [source,terminal]
 ----
@@ -553,7 +553,7 @@ $ rosa describe cluster --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Example
-Describe a cluster named `mycluster`:
+Describe a cluster named `mycluster`.
 [source,terminal]
 ----
 $ rosa describe cluster --cluster=mycluster

modules/rosa-upgrade-cluster-cli.adoc

@@ -2,11 +2,10 @@
 // Module included in the following assemblies:
 //
 // * cli_reference/rosa_cli/rosa-manage-objects-cli.adoc
-
+:_content-type: REFERENCE
 [id="rosa-upgrading-cluster_{context}"]
 = Upgrade and delete upgrade for clusters
 
-
 This section describes the `upgrade` command usage for clusters.
 
 [id="rosa-upgrade-cluster_{context}"]
@@ -54,14 +53,14 @@ $ rosa upgrade cluster --cluster=<cluster_name> | <cluster_id> [arguments]
 |===
 
 .Examples
-Interactively schedule an upgrade on a cluster named `mycluster`:
+Interactively schedule an upgrade on a cluster named `mycluster`.
 
 [source,terminal]
 ----
 $ rosa upgrade cluster --cluster=mycluster --interactive
 ----
 
-Schedule a cluster upgrade within the hour on a cluster named `mycluster`:
+Schedule a cluster upgrade within the hour on a cluster named `mycluster`.
 
 [source,terminal]
 ----
@@ -71,7 +70,7 @@ $ rosa upgrade cluster --cluster=mycluster --version 4.5.20
 [id="rosa-delete-upgrade-cluster_{context}"]
 == delete upgrade
 
-Cancel a scheduled cluster upgrade:
+Cancel a scheduled cluster upgrade.
 
 .Syntax
 [source,terminal]