Merge pull request #90378 from ShawnJackson/cluster-administration

edit pass: cluster-administration

Author: Ja-Dunn

articles/openshift/cluster-administration-cluster-admin-role.md

@@ -1,38 +1,40 @@
 ---
 title: Azure Red Hat OpenShift cluster administrator role | Microsoft Docs
-description:  Azure Red Hat OpenShift cluster administrator role assignment and usage
+description:  Assignment and usage of the Azure Red Hat OpenShift cluster administrator role
 services: container-service
 author: mjudeikis
 ms.author: b-majude
 ms.author: jzim
 ms.service: container-service
 ms.topic: article
 ms.date: 09/25/2019
-#Customer intent: As a developer, I need to understand how to administer and Azure Red Hat cluster using administrative role
+#Customer intent: As a developer, I need to understand how to administer an Azure Red Hat cluster by using the administrative role
 ---
 
 # Azure Red Hat OpenShift customer administrator role
 
-As an ARO (Azure Red Hat OpenShift) cluster administrator of an OpenShift cluster, your account has increased permissions and access to all user-created projects.
+You're the cluster administrator of an Azure Red Hat OpenShift cluster. Your account has increased permissions and access to all user-created projects.
 
-When your account has the osa-customer-admins authorization role bound to it, it can automatically manage a project.
+When your account has the osa-customer-admin authorization role bound to it, it can automatically manage a project.
 
 > [!Note] 
-> osa-customer-admin clusterrole is not the same as cluster-admin clusterrole
+> The osa-customer-admin cluster role is not the same as the cluster-admin cluster role.
 
 
 For example, you can execute actions associated with a set of verbs (`create`) to operate on a set of resource names (`templates`). To view the details of these roles and their sets of verbs and resources, run the following command:
 
 `$ oc describe clusterrole/osa-customer-admin`
 
-The verb names do not necessarily all map directly to oc commands, but rather equate more generally to the types of CLI operations you can perform. For example, having the `list` verb means that you can display a list of all objects of a given resource name (`oc get`), while the `get` verb means that you can display the details of a specific object if you know its name (`oc describe`).
+The verb names don't necessarily all map directly to `oc` commands. They equate more generally to the types of CLI operations that you can perform. 
 
-## How to configure customer administrator role
+For example, having the `list` verb means that you can display a list of all objects of a resource name (`oc get`). The `get` verb means that you can display the details of a specific object if you know its name (`oc describe`).
 
-Customer administrator role can be configured only during cluster creation by providing flag `--customer-admin-group-id`. How to configure Azure Active Directory and Administrators group follow how to guide: [Azure Active Directory integration for Azure Red Hat OpenShift](howto-aad-app-configuration.md)
+## Configure the customer administrator role
+
+You can configure the customer administrator role only during cluster creation by providing the flag `--customer-admin-group-id`. To learn how to configure Azure Active Directory and the Administrators group, see [Azure Active Directory integration for Azure Red Hat OpenShift](howto-aad-app-configuration.md).
 
 ## Next steps
 
-How to configure osa-customer-admin role:
+Configure the osa-customer-admin role:
 > [!div class="nextstepaction"]
 > [Azure Active Directory integration for Azure Red Hat OpenShift](howto-aad-app-configuration.md)

articles/openshift/cluster-administration-security-context-constraints.md

@@ -1,6 +1,6 @@
 ---
-title: Managing security context constraints in Azure Red Hat OpenShift | Microsoft Docs
-description:  Azure Red Hat OpenShift cluster administrator managing security context constraints
+title: Manage security context constraints in Azure Red Hat OpenShift | Microsoft Docs
+description:  Security context constraints for Azure Red Hat OpenShift cluster administrators
 services: container-service
 author: troy0820
 ms.author: b-trconn
@@ -10,13 +10,13 @@ ms.topic: article
 ms.date: 09/25/2019
 #Customer intent: As a developer, I need to understand how to manage security context constraints.
 ---
-# Overview 
+# Manage security context constraints in Azure Red Hat OpenShift 
 
-Security context constraints allow administrators to control permissions for pods. To learn more about this API type, see the [security context constraints](https://https://docs.openshift.com/container-platform/3.11/architecture/additional_concepts/authorization.html) (SCCs) architecture documentation. You can manage SCCs in your instance as normal API objects using the CLI.
+Security context constraints (SCCs) allow cluster administrators to control permissions for pods. To learn more about this API type, see the [architecture documentation for SCCs](https://https://docs.openshift.com/container-platform/3.11/architecture/additional_concepts/authorization.html). You can manage SCCs in your instance as normal API objects by using the CLI.
 
-## Listing security context constraints
+## List security context constraints
 
-To get a current list of SCCs 
+To get a current list of SCCs, use this command: 
 
 ```bash
 $ oc get scc
@@ -31,9 +31,9 @@ privileged         true      [*]       RunAsAny    RunAsAny           RunAsAny
 restricted         false     []        MustRunAs   MustRunAsRange     MustRunAs   RunAsAny    <none>     false            [configMap downwardAPI emptyDir persistentVolumeClaim secret]
 ```
 
-## Examining a security context constraints object
+## Examine an object for security context constraints
 
-To examine a particular SCC, use `oc get`, `oc describe`, or `oc edit`.  For example, to examine the **restricted** SCC:
+To examine a particular SCC, use `oc get`, `oc describe`, or `oc edit`.  For example, to examine the **restricted** SCC, use this command:
 ```bash
 $ oc describe scc restricted
 Name:					restricted
@@ -68,6 +68,5 @@ Settings:
     Ranges:				<none>
 ```
 ## Next steps
-How to configure osa-customer-admin role:
 > [!div class="nextstepaction"]
-> [Azure Active Directory integration for Azure Red Hat OpenShift](howto-aad-app-configuration.md) 
+> [Create an Azure Red Hat OpenShift cluster](tutorial-create-cluster.md)