OSDOCS-4752 Pre-GA docs nit corrections

Author: ShaunaDiaz

_topic_maps/_topic_map_ms.yml

@@ -89,8 +89,8 @@ Topics:
     File: getting-started-cli
   - Name: Configuring the OpenShift CLI
     File: configuring-cli
-  - Name: Managing CLI profiles
-    File: managing-cli-profiles
+  # - Name: Managing CLI profiles
+  #   File: managing-cli-profiles
   - Name: Extending the OpenShift CLI with plug-ins
     File: extending-cli-plugins
   # FIXME: auto-generated content in the next file includes commands

cli_reference/index.adoc

@@ -24,7 +24,10 @@ These tools expose simple commands to manage the applications, as well as intera
 
 The following set of CLI tools are available in {product-title}:
 
-* xref:../cli_reference/openshift_cli/getting-started-cli.adoc#cli-getting-started[OpenShift CLI (oc)]: This is the most commonly used CLI tool by {product-title} users. It helps both cluster administrators and developers to perform end-to-end operations across {product-title} using the terminal. Unlike the web console, it allows the user to work directly with the project source code using command scripts.
+* xref:../cli_reference/openshift_cli/getting-started-cli.adoc#cli-getting-started[OpenShift CLI (oc)]: This is the most commonly used CLI tool by {product-title} users. It helps both cluster administrators and developers to perform end-to-end operations across {product-title} using the terminal. 
+ifndef::microshift[]
+Unlike the web console, it allows the user to work directly with the project source code using command scripts.
+endif::microshift[]
 
 ifndef::microshift[]
 * xref:../cli_reference/kn-cli-tools.adoc#kn-cli-tools[Knative CLI (kn)]: The Knative (`kn`) CLI tool provides simple and intuitive terminal commands that can be used to interact with OpenShift Serverless components, such as Knative Serving and Eventing.

microshift_getting_started/microshift-architecture.adoc

@@ -16,7 +16,7 @@ Learn the specifics of {product-title} architecture including design intent, how
 * Devices with {product-title} installed are self-managing
 * Compatible with rpm-ostree-based systems
 * Uses only the APIs needed for essential functions, such as security and runtime controls
-* Reuses select commands from the OpenShift CLI (`oc`) tool
+* Enables a subset of commands from the OpenShift CLI (`oc`) tool
 
 // * You can use in locations where full control is needed
 // * Works offline and in low-connectivity environments

microshift_getting_started/microshift-understanding.adoc

@@ -6,7 +6,7 @@ include::_attributes/attributes-microshift.adoc[]
 
 toc::[]
 
-Get an overview of what you can do with {product-title}, a distribution of {OCP} designed for optimizing small form factors and edge computing.
+Get an overview of what you can do with {product-title}, a distribution of {OCP} designed for optimizing small form factor devices and edge computing.
 
 include::modules/about-microshift.adoc[leveloffset=+1]
 

microshift_install/microshift-install-rhel-for-edge.adoc

@@ -5,15 +5,15 @@ include::_attributes/attributes-microshift.adoc[]
 :context: microshift-install-rhel-for-edge
 toc::[]
 
-You can embed MicroShift into a {op-system-ostree-first} {op-system-version} image.
+You can embed {product-title} into a {op-system-ostree-first} {op-system-version} image.
 
-== Embedding MicroShift into a {op-system-ostree} image
+= Embedding {product-title} into a {op-system-ostree} image
 
-Use the content within this section to build a {op-system-ostree-first} {op-system-version} image containing MicroShift.
+Use the content within this section to build a {op-system-ostree-first} {op-system-version} image containing {product-title}.
 
 [NOTE]
 ====
-{op-system} 9.0 is currently unsupported for MicroShift deployments.
+{op-system} 9.0 is currently unsupported for {product-title} deployments.
 ====
 
 //include modules/prerequisites-for-installing-microshift.adoc

microshift_install/microshift-install-rpm.adoc

@@ -1,29 +1,49 @@
 :_content-type: ASSEMBLY
 [id="microshift-install-rpm"]
-= Installing MicroShift from an RPM package
+= Installing {product-title} from an RPM package
 include::_attributes/attributes-microshift.adoc[]
 :context: microshift-install-rpm
 toc::[]
 
-You can install {product-title} from an RPM package on a machine with {op-system-first} {op-system-version}. 
+You can install {product-title} from an RPM package on a machine with {op-system-first} {op-system-version}.
 
 [IMPORTANT]
 ====
 Red Hat will not provide or support an update or upgrade path from Developer Preview and Technology Preview versions to later versions of {product-title}. A new installation will be necessary.
 ====
 
-include::modules/system-requirements-installing-microshift.adoc[leveloffset=+1]
+include::modules/microshift-install-system-requirements.adoc[leveloffset=+1]
 
-include::modules/preparing-for-installing-microshift-rpm.adoc[leveloffset=+1]
+include::modules/microshift-install-rpm-preparing.adoc[leveloffset=+1]
 
-include::modules/installing-microshift-rpm.adoc[leveloffset=+1]
+[role="_additional-resources"]
+.Additional resources
 
-include::modules/starting-microshift-service.adoc[leveloffset=+1]
+* xref:../microshift_install/microshift-install-rpm.adoc#system-requirements-installing-microshift[System Requirements for Installing MicroShift] have been met.
 
-include::modules/stopping-microshift-service.adoc[leveloffset=+1]
+* Download the link:https://console.redhat.com/openshift/install/pull-secret[pull secret] from the Red Hat Hybrid Cloud Console.
 
-include::modules/accessing-microshift.adoc[leveloffset=+1]
+* xref:../microshift_configuring/microshift-using-config-tools.adoc#microshift-using-config-tools[Configuring MicroShift].
 
-include::modules/accessing-microshift-cluster-locally.adoc[leveloffset=+2]
+* For more options on partition configuration, see link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/performing_a_standard_rhel_8_installation/index#manual-partitioning_graphical-installation[Configuring Manual Partitioning].
 
-include::modules/accessing-microshift-cluster-remotely.adoc[leveloffset=+2]
+* For more information about resizing your existing LVs to free up capacity in your VGs, see link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/configuring_and_managing_logical_volumes/index#managing-lvm-volume-groups_configuring-and-managing-logical-volumes[Managing LVM Volume Groups]
+
+include::modules/microshift-installing-from-rpm.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../microshift_install/microshift-install-rpm.adoc#system-requirements-installing-microshift[system requirements for installing MicroShift] have been met.
+
+* xref:../microshift_install/microshift-install-rpm.adoc#preparing-install-microshift-from-rpm-package_microshift-install-rpm[Preparing to install MicroShift from an RPM package].
+
+include::modules/microshift-service-starting.adoc[leveloffset=+1]
+
+include::modules/microshift-service-stopping.adoc[leveloffset=+1]
+
+include::modules/microshift-accessing.adoc[leveloffset=+1]
+
+include::modules/microshift-accessing-cluster-locally.adoc[leveloffset=+2]
+
+include::modules/microshift-accessing-cluster-remotely.adoc[leveloffset=+2]

modules/about-microshift.adoc

@@ -5,7 +5,7 @@
 [id="con-about-microshift_{context}"]
 = About {product-title}
 
-Working with low-resource field environments and hardware presents many challenges not experienced with cloud computing. {product-title} enables you to solve problems for edge devices by:
+Working with resource-constrained field environments and hardware presents many challenges not experienced with cloud computing. {product-title} enables you to solve problems for edge devices by:
 
 * Overcoming the operational challenge of minimal system resources, for example, a {op-system-chip}.
 * Addressing the environmental challenges of severe networking constraints such as low or no connectivity.