Mike feedback

Author: jhlodin

src/current/_includes/cockroachcloud/cluster-operator-prereq.md

@@ -1 +1 @@
-Either the [Cluster Operator]({% link cockroachcloud/authorization.md %}#cluster-operator) or [Cluster Admin]({% link cockroachcloud/authorization.md %}#cluster-admin) role on a pre-existing cluster, or the [Cluster Creator](authorization.html#cluster-creator) role in order to create a new cluster.
+Either the [Cluster Operator]({% link cockroachcloud/authorization.md %}#cluster-operator) or [Cluster Admin]({% link cockroachcloud/authorization.md %}#cluster-admin) role on an existing cluster, or the [Cluster Creator](authorization.html#cluster-creator) role in order to create a new cluster.

src/current/_includes/cockroachcloud/cockroachcloud-ask-admin.md

@@ -1,3 +1,3 @@
 {{site.data.alerts.callout_info}}
-Only [Organization Admins]({% link cockroachcloud/authorization.md %}#organization-admin) and [Cluster Admins]({% link cockroachcloud/authorization.md %}#cluster-admin) can create SQL users and issue credentials.
+Only [Organization Admins]({% link cockroachcloud/authorization.md %}#organization-admin) and [Cluster Admins]({% link cockroachcloud/authorization.md %}#cluster-admin) can create SQL users using the {{site.data.products.cloud}} Console or API. These SQL users default to the `Admin` role. For granular provisioning of SQL user privileges, refer to documentation on [using the cluster's SQL interface]({% link cockroachcloud/managing-access.md %}?filters=client#create-a-sql-user).
 {{site.data.alerts.end}}

src/current/_includes/cockroachcloud/org-roles/cloud-roles-table.md

@@ -5,7 +5,7 @@ The following table describes the high level permissions given by each Cockroach
 | `Organization Member` | None | None | None | None | None | None | None | None | None |
 | `Organization Admin` | Manage users and service accounts, assign and revoke roles | None | None | None | None | None | None | None | Manage [enterprise (self-hosted) licenses]({% link {{ site.current_cloud_version }}/licensing-faqs.md %}#obtain-a-license), manage email alerts |
 | `Billing Coordinator` | None | Manage billing | None | None | None | None | None | None | None |
-| `Cluster Operator` | None | None | Scale nodes, upgrade CockroachDB | Manage Databases | View metrics / insights / logs / jobs | Manage network auth, configure SQL SSO, view PCI status | View / restore backups | None | Access DB console, configure maintenance windows, send test alerts |
+| `Cluster Operator` | None | None | Scale nodes, upgrade CockroachDB | Manage databases | View metrics / insights / logs / jobs | Manage network auth, configure SQL SSO, view PCI status | View / restore backups | None | Access DB console, configure maintenance windows, send test alerts |
 | `Cluster Admin` | Manage SQL users, manage service accounts, assign user roles | None | Create / edit / delete cluster, scale nodes, upgrade CockroachDB | Manage databases | View metrics / insights | Manage network auth, configure SQL SSO, view PCI status | View / restore backups | None, unless role is assigned with organization scope | Access DB console, configure maintenance windows |
 | `Cluster Creator` | None | None | Create cluster (assigns `Cluster Admin` role for that cluster), edit / delete clusters created by this user | None | None | None, unless role is assigned with organization scope | None | None, unless role is assigned with organization scope | None |
 | `Cluster Developer` | None | None | None | None | None | None | None | None | Access DB console, view cluster details |

src/current/cockroachcloud/folders.md

@@ -99,7 +99,7 @@ To create clusters in a folder, the member must also have the `CLUSTER_ADMIN` or
 
 To assign the `FOLDER_ADMIN` role:
 
-1. On the **Access Management** page, locate the team member's details whose role you want to change.
+1. On the **Access Management** page, locate the team member whose role you want to change.
 1. In the row for the target member, click the three-dots **Action** button and select **Edit Roles**.
 1. Set **Scope** to **Organization** or to a folder in the hierarchy. The role is assigned on all of the folder's descendants.
 1. Set **Role** to **Folder Admin** or **Folder Mover**.

src/current/cockroachcloud/managing-access.md

@@ -46,7 +46,7 @@ In the CockroachDB {{ site.data.products.cloud }} Console, users must be assigne
 
 To edit a user's role, perform the following steps:
 
-1. On the **Access Management** page, locate the team member's details whose role you want to change. The **Role** column lists current roles assigned to each user.
+1. On the **Access Management** page, locate the team member whose role you want to change. The **Role** column lists current roles assigned to each user.
 1. In the row for the target member, click the three-dots **Action** button and select **Edit Roles**.
 1. A number of fine-grained roles can be assigned to a given user. Each role is represented by a row. Each row has a **scope**, which is one of **Organization**, the name of a particular [folder]({% link cockroachcloud/folders.md %}), or the name of a particular cluster. If the role is Cluster Admin, Cluster Operator, or Cluster Developer, assigning it at the organization scope means that it applies to all clusters in the organization.
 
@@ -66,7 +66,7 @@ An [Organization Admin]({% link cockroachcloud/authorization.md %}#organization-
 
 ### Revoke a pending invite
 
-1. On the **Access Management** page, locate the team member's details whose pending invite you want to revoke.
+1. On the **Access Management** page, locate the team member whose pending invite you want to revoke.
 1. In the **Action** column, click the three dots to view the allowed actions.
 1. Click **Revoke Invite**.