address PR feedback

Author: Tyler Whitney

articles/openshift/howto-aad-app-configuration.md

@@ -1,6 +1,6 @@
 ---
-title: Create an Azure Application for your Azure Red Hat Open Shift cluster | Microsoft Docs
-description: Shows you how to create an Azure application object so that you can use Open Shift on Azure
+title: Create an Azure Application for your Azure Red Hat OpenShift cluster | Microsoft Docs
+description: Shows you how to create an Azure application object so that you can use OpenShift on Azure
 documentationcenter: .net
 author: tylermsft
 ms.author: twhitney
@@ -10,23 +10,23 @@ editor: ''
 ms.topic: conceptual
 ms.tgt_pltfrm: NA
 ms.workload: NA
-ms.date: 5/6/2019
+ms.date: 05/06/2019
 ---
 
 # How to create a new app registration and new Azure Active Directory user
 
-Microsoft Azure Red Hat OpenShift needs permissions to perform tasks on behalf of your cluster in Azure. If your organization doesn't already have an Azure Active Directory (AD) app registration you can use as the service principal in Azure Active Directory, follow these instructions to create one.
+Microsoft Azure Red Hat OpenShift needs permissions to perform tasks on behalf of your cluster in Azure. If your organization doesn't already have an Azure Active Directory (Azure AD) app registration you can use as the service principal in Azure Active Directory, follow these instructions to create one.
 
-This topic concludes with instructions for creating a new AD user that you'll need to access apps running on your ARO cluster.
+This topic concludes with instructions for creating a new Azure AD user that you'll need to access apps running on your Azure Red Hat OpenShift cluster.
 
 ## Create a new app registration
 
 An application that wants to use the capabilities of Azure AD must first be registered in an Azure AD tenant. This registration process involves giving Azure AD details about your application such as the URL where the app is  located, the URL to send replies after a user is authenticated, the URI that identifies the app, and so on.
 
 1. In the [Azure portal](https://portal.azure.com), ensure that your tenant appears under your user name in the top right of the portal:
-![Tenant display][tenantcallout]
+![Screenshot of portal with tenant listed in top right][tenantcallout]
 If the wrong tenant is displayed, click on your user name in the top right, then click **Switch Directory**, and select the directory created above from the **All Directories** list.
-2. Click on the following link to go to the [App registrations blade](https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps)
+2. Go to the [App registrations blade](https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps)
 3. The **App registrations** blade appears. Click **+New application registration**.
 4. In the **Create** pane, enter a friendly name (can be any name) for your application.
 5. Ensure that **Application type** is set to **Web app/API**.
@@ -42,10 +42,10 @@ Refer to [Register an app with the Azure Active Directory v1.0 endpoint](https:/
 Next, generate a client secret.
 
 1. While still in the portal on the **Registered App** page from the previous step, copy the **Application ID** and save it where you can refer to it later. We will refer to this value as `APPID` in the tutorials.
-![App id][appidimage]
+![Screenshot of the application id textbox][appidimage]
 2. Click on **Settings** to open the settings for your registered app.
 3. On the **Settings** pane that appears, click **Keys**.  The Keys pane appears.
-![Create key][createkeyimage]
+![Screenshot of the create key page in the portal][createkeyimage]
 4. Provide a **Key description**.
 5. Set the expiration duration to **In 2 years**
 6. Click **Save** and the key value will appear.
@@ -61,7 +61,7 @@ Azure Active Directory uses the app object reply URL to specify the callback to
 
 ## Create a new Active Directory user
 
-Create a new user in Active Directory that you'll use to sign in to the app running on your ARO cluster.
+Create a new user in Active Directory that you'll use to sign in to the app running on your Azure Red Hat OpenShift cluster.
 
 1. Click this [link](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade/AllUsers) to go to the **Users - All users** pane.
 2. Click **+ New user**. The **User** pane appears.
@@ -82,4 +82,4 @@ Create a new user in Active Directory that you'll use to sign in to the app runn
 
 ## Next steps
 
-Try the [Create an Azure Red Hat Openshift cluster](tutorial-create-cluster.md) tutorial.
+Try the [Create an Azure Red Hat OpenShift cluster](tutorial-create-cluster.md) tutorial.

articles/openshift/howto-create-tenant.md

@@ -1,5 +1,5 @@
 ---
-title: Create a tenant for your Azure Open Shift cluster | Microsoft Docs
+title: Create a tenant for your Azure OpenShift cluster | Microsoft Docs
 description: Shows you how to create a tenant and Azure application object so that you can use OpenShift on Azure
 documentationcenter: .net
 author: tylermsft
@@ -8,10 +8,10 @@ ms.service: container-service
 manager: jeconnoc
 editor: ''
 ms.topic: conceptual
-ms.date: 5/6/2019
+ms.date: 05/06/2019
 ---
 
-# How to create a tenant for your ARO cluster
+# How to create a tenant for your Azure Red Hat OpenShift cluster
 
 Before you can create a Microsoft Azure Red Hat OpenShift cluster, you need a tenant in which to create the cluster. Follow these instructions to create an Azure tenant if you don't already have one.
 
@@ -27,7 +27,7 @@ To create a tenant:
 4. Provide an **Initial domain name**. What you put here will have *onmicrosoft.com* appended to it. You can use what you put for **Organization name** here.
 5. At the bottom of the page click **Create**.
 6. After your tenant (Azure Active Directory) is created, click on **Click here to manage your new directory**. Your tenant will be displayed in the upper right of the Azure portal:
-![Tenant display][tenantcallout]
+![Screenshot of the portal showing the tenant name in the upper-right][tenantcallout]
 7. We need to get the tenant ID to specify where to create the cluster later. On the portal, you should now see the Azure Active Directory blade for your new tenant. In the **Manage** section of the **Azure Active Directory** blade, click **Properties**. Copy the value for **Directory ID**. We will refer to this value as the `TENANT` later in the docs.
 
 Refer to [Set up a dev environment](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant) for more detailed instructions about setting up an Azure tenant.

articles/openshift/howto-setup-environment.md

@@ -2,23 +2,23 @@
 title: Set up your Azure Red Hat OpenShift development environment | Microsoft Docs
 description: Set up your Microsoft Red Hat OpenShift development environment
 services: openshift
-keywords:  red hat open shift setup
+keywords:  red hat openshift setup set up
 author: TylerMSFT
 ms.author: twhitney
-ms.date: 5/6/2019
+ms.date: 05/06/2019
 ms.topic: conceptual
 ms.service: openshift
 manager: jeconnoc
-#Customer intent: As a developer, I need to install the prerequisites so I can create an Azure Red Hat Openshift cluster
+#Customer intent: As a developer, I need to install the prerequisites so I can create an Azure Red Hat OpenShift cluster
 ---
 
 # Set up your Microsoft Azure Red Hat OpenShift dev environment
 
-To build and run Microsoft Azure Red Hat OpenShift (ARO) applications on your Windows development machine, you'll need:
+To build and run Microsoft Azure Red Hat OpenShift applications on your Windows development machine, you'll need:
 
 * Version 2.0.43 or higher of the Azure CLI (or use the Azure Cloud Shell)
 * A tenant (Azure Active Directory) for your OpenShift cluster
-* An Azure Active Directory (AAD) application object and Active Directory user object
+* An Azure Active Directory (Azure AD) application object and Active Directory user object
 * Manually register providers and features
 
 The following instructions will help you get everything ready.
@@ -35,59 +35,59 @@ The first line of output will have the CLI version, for example `azure-cli (2.0.
 
 ## Create a tenant (Azure Active Directory)
 
-Before you can create an Azure Red Hat OpenShift cluster, you need a tenant (an Azure Active Directory (AAD)) for it.
+Before you can create an Azure Red Hat Azure Red Hat OpenShift cluster, you need a tenant (an Azure Active Directory (Azure AD)) for it.
 
-If you don't have an AAD to use as the tenant for your OpenShift cluster, or you wish to create a tenant for testing, follow the instructions in [Create a tenant for your Azure Open Shift cluster](howto-create-tenant.md) before continuing with these instructions.
+If you don't have an Azure AD to use as the tenant for your Azure Red Hat OpenShift cluster, or you wish to create a tenant for testing, follow the instructions in [Create a tenant for your Azure OpenShift cluster](howto-create-tenant.md) before continuing with these instructions.
 
 ## Create an Azure Active Directory application object and user
 
-Before you can create an Azure Red Hat OpenShift cluster, you also need an app registration that allows the cluster to perform functions such as configuring storage. You'll also need to create a new user in AAD to use to sign in to the app running on your ARO cluster.
+Before you can create an Azure Red Hat OpenShift cluster, you also need an app registration that allows the cluster to perform functions such as configuring storage. You'll also need to create a new user in Azure AD to use to sign in to the app running on your Azure Red Hat OpenShift cluster.
 
-If you don't have an app registration in the AAD tenant you are using to create your ARO cluster, or don't have a AAD user to use to sign in to your cluster, follow the instructions in [Create an Azure Active Directory application object](howto-aad-app-configuration.md).
+If you don't have an app registration in the Azure AD tenant you are using to create your Azure Red Hat OpenShift cluster, or don't have a Azure AD user to use to sign in to your cluster, follow the instructions in [Create an Azure Active Directory application object](howto-aad-app-configuration.md).
 
 ## Register providers and features
 
-The `Microsoft.ContainerService openshiftmanagedcluster` feature, `Microsoft.Solutions` and `Microsoft.Network` providers must be registered to your subscription manually before deploying your first ARO cluster.
+The `Microsoft.ContainerService openshiftmanagedcluster` feature, `Microsoft.Solutions` and `Microsoft.Network` providers must be registered to your subscription manually before deploying your first Azure Red Hat OpenShift cluster.
 
 To register these providers and features manually, use the following instructions:
 
 1. Start an Azure Cloud Shell (Bash) session from the Azure portal.
 2. If you have access to multiple subscriptions, specify the relevant
   subscription ID:
 
-```bash
-az account set --subscription <SUBSCRIPTION ID>
-```
+    ```bash
+    az account set --subscription <SUBSCRIPTION ID>
+    ```
 
 3. Register the Microsoft.ContainerService openshiftmanagedcluster feature:
 
-```bash
-az feature register --namespace Microsoft.ContainerService -n openshiftmanagedcluster
-```
+    ```bash
+    az feature register --namespace Microsoft.ContainerService -n openshiftmanagedcluster
+    ```
 
 4. Register the Microsoft.Solutions provider:
 
-```bash
-az provider register -n Microsoft.Solutions --wait
-```
+    ```bash
+    az provider register -n Microsoft.Solutions --wait
+    ```
 
 5. Register the Microsoft.Network provider:
 
-```bash
-az provider register -n Microsoft.Network --wait
-```
+    ```bash
+    az provider register -n Microsoft.Network --wait
+    ```
 
 6. Refresh the registration of the Microsoft.ContainerService resource provider:
 
-```bash
-az provider register -n Microsoft.ContainerService --wait
-```
+    ```bash
+    az provider register -n Microsoft.ContainerService --wait
+    ```
 
-You're now ready to create Azure Red Hat Openshift applications.
+You're now ready to create Azure Red Hat OpenShift applications.
 
 ## Next steps
 
-Try the [Create an Azure Red Hat Openshift cluster](tutorial-create-cluster.md) tutorial.
+Try the [Create an Azure Red Hat OpenShift cluster](tutorial-create-cluster.md) tutorial.
 Find answers to [common questions and known issues](openshift-faq.md).
 
 [azure-cli-install]: https://docs.microsoft.com/cli/azure/install-azure-cli

articles/openshift/index.yml

@@ -1,10 +1,10 @@
 ### YamlMime:YamlDocument
 documentType: LandingData
-title: Microsoft Azure Red Hat OpenShift Service (AOS)
+title: Microsoft Azure Red Hat OpenShift Service
 metadata:
   document_id:
-  title: Microsoft Azure Red Hat OpenShift Service (AOS) Documentation - Tutorials, API Reference | Microsoft Docs
-  meta.description: AOS allows you to quickly deploy a production ready Red Hat OpenShift cluster in Azure. Learn how to use AOS with these tutorials and how-to guides.
+  title: Microsoft Azure Red Hat OpenShift Service Documentation - Tutorials, API Reference | Microsoft Docs
+  meta.description: Azure Red Hat OpenShift allows you to quickly deploy a production ready Red Hat OpenShift cluster in Azure. Learn how to use Azure Red Hat OpenShift with these tutorials and how-to guides.
   services: container-service
   author: tylermsft
   manager: jeconnoc
@@ -15,18 +15,18 @@ metadata:
   ms.date: 05-06-2019
   ms.author: twhitney
 abstract:
-  description: 'Microsoft Azure Red Hat OpenShift Service (AOS) provides a self-service deployment of fully managed OpenShift clusters that allows you to maintain regulatory compliance while focusing on your application development.'
+  description: 'Azure Red Hat OpenShift provides fully managed OpenShift clusters that allow you to focus on app development while providing regulatory compliance .'
 sections:
 - title: Step-by-Step Tutorials
   items:
   - type: paragraph
-    text: 'Learn how to create and manage an AOS cluster.'
+    text: 'Learn how to create and manage an Azure Red Hat OpenShift cluster.'
   - type: list
     style: ordered
     items:
-    - html: <a href="/azure/openshift/tutorial-create-cluster">Create an ARO cluster</a>
-    - html: <a href="/azure/openshift/tutorial-scale-cluster">Scale an ARO cluster</a>
-    - html: <a href="/azure/openshift/tutorial-delete-cluster">Delete an ARO cluster</a>
+    - html: <a href="/azure/openshift/tutorial-create-cluster">Create an Azure Red Hat OpenShift cluster</a>
+    - html: <a href="/azure/openshift/tutorial-scale-cluster">Scale an Azure Red Hat OpenShift cluster</a>
+    - html: <a href="/azure/openshift/tutorial-delete-cluster">Delete an Azure Red Hat OpenShift cluster</a>
 
 - title: Reference
   items:
@@ -39,4 +39,4 @@ sections:
     - title: REST
       html: <p><a href="/rest/api/aks">REST API</a></p>
     - title: Red Hat OpenShift dedicated documentation
-      html: <p><a href="https://access.redhat.com/documentation/openshift_dedicated/3/)"
+      html: <p><a href="https://access.redhat.com/documentation/openshift_dedicated/3/)"</a></p>

articles/openshift/intro-openshift.md

@@ -1,39 +1,39 @@
 ---
-title: Introduction to Microsoft Azure Red Hat OpenShift (ARO)
-description: Learn the features and benefits of Azure Red Hat OpenShift (ARO) to deploy and manage container-based applications in Azure.
+title: Introduction to Microsoft Azure Red Hat OpenShift
+description: Learn the features and benefits of Azure Red Hat OpenShift to deploy and manage container-based applications in Azure.
 services: container-service
 author: tylermsft
 ms.author: twhitney
 ms.service: container-service
 manager: jeconnoc
 ms.topic: overview
-ms.date: 05/6/2019
+ms.date: 005/06/2019
 ms.custom: mvc
 ---
 
 # Microsoft Azure Red Hat OpenShift Service
 
-Microsoft Azure Red Hat OpenShift (ARO) provides a self-service deployment of fully managed OpenShift clusters that allows you to maintain regulatory compliance while focusing on your application develpopment. ARO is jointly engineered, operated, and supported by both Microsoft and Red Hat. It provides an integrated support experience. Clusters are deployed into your Azure subscription and are included on your Azure bill.
+Microsoft Azure Red Hat OpenShift provides a self-service deployment of fully managed OpenShift clusters that allows you to maintain regulatory compliance while focusing on your application development. Azure Red Hat OpenShift is jointly engineered, operated, and supported by both Microsoft and Red Hat. It provides an integrated support experience. Clusters are deployed into your Azure subscription and are included on your Azure bill.
 
 Master, infrastructure and application nodes are patched, updated, and monitored by Microsoft and Red Hat. Choose your own registry, networking, storage, or CI/CD solutions. Or get going with immediately using built-in solutions automated source code management, container and application builds, deployments, scaling, health management, and more.
 
-There are no virtual machines to operate. No patching is required. ARO provides an integrated sign-on experience through Azure Active Directory and regulatory compliance with SOC, ISO, PCI DSS, and HIPAA.
+There are no virtual machines to operate. No patching is required. Azure Red Hat OpenShift provides an integrated sign-on experience through Azure Active Directory and regulatory compliance with SOC, ISO, PCI DSS, and HIPAA.
 
-OpenShift extends Kubernetes. Running containers in production with Kubernetes requires additional tools and resources, such as an image registry, storage management, networking solutions, and logging and monitoring tools, all of which must be versioned and tested together.
+Azure Red Hat OpenShift extends Kubernetes. Running containers in production with Kubernetes requires additional tools and resources, such as an image registry, storage management, networking solutions, and logging and monitoring tools, all of which must be versioned and tested together.
 
 Building container-based applications requires even more integration work with middleware, frameworks, databases, and CI/CD tools.
 
-OpenShift combines these into a single platform, bringing ease of operations to IT teams while giving application teams what they need to execute.
+Azure Red Hat OpenShift combines these into a single platform, bringing ease of operations to IT teams while giving application teams what they need to execute.
 
-To get started, complete the [Deploy a Red Hat OpenShift cluster on Azure](tutorial-create-cluster.md) tutorial.
+To get started, complete the [Deploy a Microsoft Red Hat OpenShift cluster on Azure](tutorial-create-cluster.md) tutorial.
 
 ## Access, security, and monitoring
 
-For improved security and management, ARO lets you integrate with Azure Active Directory and use Kubernetes role-based access controls. You can also monitor the health of your cluster and resources.
+For improved security and management, Azure Red Hat OpenShift lets you integrate with Azure Active Directory and use Kubernetes role-based access controls. You can also monitor the health of your cluster and resources.
 
 ## Cluster and node
 
-ARO nodes run on Azure virtual machines. You can connect storage to nodes and pods, upgrade cluster components, and use GPUs.
+Azure Red Hat OpenShift nodes run on Azure virtual machines. You can connect storage to nodes and pods, upgrade cluster components, and use GPUs.
 
 ## Virtual networks and ingress
 
@@ -51,4 +51,4 @@ Azure Red Hat OpenShift service is compliant with SOC, ISO, PCI DSS, and HIPAA.
 
 ## Next steps
 
-Try the [Create an Azure Red Hat Openshift cluster](tutorial-create-cluster.md) tutorial.
+Try the [Create an Azure Red Hat OpenShift cluster](tutorial-create-cluster.md) tutorial.