SME feedback pt 1

Author: skopacz1

modules/installing-ove-booting.adoc

@@ -21,13 +21,20 @@ To initiate the cluster installation, attach the downloaded ISO to each machine
 . Configure the rendezvous node for the cluster installation:
 
 .. On the machine that you want to run as the bootstrap host for the installation process, select *This is the rendezvous node* in the *Rendezvous node setup* menu.
++
+[IMPORTANT]
+====
+You must select only one machine to act as the rendezvous node.
+Selecting two or more machines as a rendezvous node is not supported.
+====
 
 .. In the *Rendezvous node IP selection* menu, select an IP address from the list to use as the rendezvous node IP address and select *Continue*.
+Make note of this address for later use.
 
 .. On another machine, enter the rendezvous node IP address in the *Rendezvous node setup* menu and select *Save rendezvous IP*.
 
 .. Select *Save and Continue*.
 
-.. Repeat the previous two steps for each remaining machine that has booted from the ISO image.
+.. Repeat the previous two steps for each remaining machine that you booted from the ISO image.
 
 . Wait for the rendezvous node to provide a URL for finishing the installation and save the URL for later use.

modules/installing-ove-console.adoc

@@ -91,8 +91,14 @@ An ingress IP provides an endpoint for application traffic flowing from outside
 
 .. Click *Next* to continue.
 
-. On the *Download credential*s page, select the checkbox to acknowledge that you must download credential files prior to cluster installation.
+. On the *Download credentials* page, select the checkbox to acknowledge that you must download credential files prior to cluster installation.
 
 . Click *Download credentials* and save the cluster credentials file in a secure location.
++
+[IMPORTANT]
+====
+You must download the credentials at this stage.
+Once you initiate the cluster installation, the rendezvous node reboots and you can no longer retrieve the credentials.
+====
 
 . On the *Review and create* page, review all of the cluster details and click *Install cluster* to initiate the cluster installation.

modules/installing-ove-iso.adoc

@@ -7,8 +7,12 @@
 = Downloading the installation ISO
 
 You must first download the ISO image that will be used to run the installation on your bare-metal machines.
-// Not sure if the following sentence is technically accurate or even a necessary detail to mention at this point in the process.
-This image includes all of the necessary {product-title} release images, which will be "pinned" to the cluster, to eliminate the need for an image registry when installing in a disconnected environment.
+This image includes all of the necessary {product-title} release images, as well as the {olm-first} Operators needed to install Virtualization on the cluster.
+
+[NOTE]
+====
+The size of the ISO image can vary depending on the release you select.
+====
 
 .Procedure
 

virt/install/installing-ove.adoc

@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-The following procedures describe a streamlined method to install a {ove-first} cluster that requires less planning and configuration compared to other installation methods.
+The following procedures describe a method to install a {ove-first} cluster that uses a simplified user interface, and does not require you to set up an external image registry in disconnected environments, which is a requirement for all other disconnected installation methods.
 
 :FeatureName: Installing an {ove} cluster using this method
 include::snippets/technology-preview.adoc[]
@@ -15,11 +15,14 @@ include::snippets/technology-preview.adoc[]
 
 This method has the following advantages for users who want to install a cluster primarily to run virtualized workloads using {VirtProductName}:
 
-* The cluster installation is performed through a graphical user interface.
+Simplified web interface:: The cluster installation is performed through a graphical user interface.
+In addition to providing reasonable default configurations, this interface guides you through the installation by providing hints and warnings about configuring your cluster, without limiting the configurations that are available at installation time.
+This reduces the need for in-depth knowledge of {product-title} while still allowing for complex configurations to be made.
 
-* You can install the Virtualization bundle, which includes all of the additional Operators needed to run virtual machines on your cluster, at the same time as the cluster installation.
+No external registry needed:: If you are installing your cluster in a disconnected environment, you do not need to configure an external image registry in your environment when using this method.
+All other disconnected installation methods require this additional environment setup.
 
-* If you are installing your cluster in a disconnected environment, you do not need to configure an image registry in your environment when using this method.
+Included Operator bundle:: You can install the Virtualization bundle, which includes all of the additional {olm-first} Operators needed to run virtual machines on your cluster, at the same time as the cluster installation.
 
 // Probably need some section for limitations such as bare metal machines, unless that's a commonly understood requirement for virt.
 
@@ -32,9 +35,10 @@ include::modules/installing-ove-booting.adoc[leveloffset=+1]
 // Configuring the cluster installation from the web console
 include::modules/installing-ove-console.adoc[leveloffset=+1]
 
-// Should I include the Agent procedure here about tracking and verifying installation progress? Or does the UI do the same thing as the `wait-for` commands?
+During the installation process, the rendezvous node reboots and the console you used to configure the installation is no longer accessible.
+At that point, the URL of the cluster web console is provided, however this console is not accessible until the cluster installation is completed.
 
-After the cluster has been installed, the installation console displays the URL of the web console, which you can visit and sign in using your downloaded credentials.
+Once the cluster is installed, you can visit this URL and sign in to the web console with your downloaded credentials.
 
 [id="next-steps_{context}"]
 == Next steps