editorial review

Author: aevesdocker

content/guides/admin-user-management/audit-and-monitor.md

@@ -27,7 +27,7 @@ It is available for Docker Team or Docker Business plans, with data retained for
 
  - Billing adjustments: Track who added or removed subscription seats to maintain budgetary control and compliance.
 
-For more information, see [Activity logs](/manuals/admin/organization/activity-logs.md)
+For more information, see [Activity logs](/manuals/admin/organization/activity-logs.md).
 
 ## Insights
 
@@ -49,4 +49,4 @@ Insights provide data-driven views of Docker usage to improve team productivity
 
  - Container utilization: Analyze container activity across departments to ensure proper resource distribution and cost efficiency.
 
- For more information, see [Insights](/manuals/admin/organization/insights.md)
+ For more information, see [Insights](/manuals/admin/organization/insights.md).

content/guides/admin-user-management/onboard.md

@@ -9,15 +9,15 @@ This page guides you through onboarding owners and members, and using tools like
 
 ## Step 1: Invite owners
 
-When you create a Docker organization, you automatically become its sole owner. While optional, adding additional owners can significantly ease the process of onboarding and managing your organization by distributing administrative responsibilities. It also ensures continuity and does not cause a blocker if the primary own is unavailable.
+When you create a Docker organization, you automatically become its sole owner. While optional, adding additional owners can significantly ease the process of onboarding and managing your organization by distributing administrative responsibilities. It also ensures continuity and does not cause a blocker if the primary owner is unavailable.
 
-For detailed information on owners, see [Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md)
+For detailed information on owners, see [Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md).
 
-## Step 2: Invite members
+## Step 2: Invite members and assign roles
 
-Members are granted controlled access to resources and enjoy enhanced organizational benefits.
+Members are granted controlled access to resources and enjoy enhanced organizational benefits. When you invite members to join you Docker organization, you immediately assign them a role.
 
-### Why invite members?
+### Benefits of inviting members
 
  - Enhanced visibility: Gain insights into user activity, making it easier to monitor access and enforce security policies.
 
@@ -29,7 +29,7 @@ Members are granted controlled access to resources and enjoy enhanced organizati
 
  - Security control: Apply and enforce security settings at an organizational level, reducing risks associated with unmanaged accounts.
 
-For detailed information, see [Manage organization members](/manuals/admin/organization/members.md)
+For detailed information, see [Manage organization members](/manuals/admin/organization/members.md).
 
 ## Step 3: Future-proof user management
 
@@ -47,7 +47,7 @@ SSO:
 
  - Simplifies onboarding as it works seamlessly with SCIM and group mapping for automated provisioning.
 
-[SSO documentation](/manuals/security/for-admins/single-sign-on/_index.md)
+[SSO documentation](/manuals/security/for-admins/single-sign-on/_index.md).
 
 ### Automate onboarding with SCIM and JIT provisioning
 
@@ -77,4 +77,4 @@ It also:
 
  - Help you scale permissions as teams grow or change.
 
-For more information on how it works, see [Group mapping](/manuals/security/for-admins/provisioning/group-mapping.md)
+For more information on how it works, see [Group mapping](/manuals/security/for-admins/provisioning/group-mapping.md).

content/guides/admin-user-management/setup.md

@@ -5,16 +5,18 @@ keywords: Docker roles, permissions management, access control, IT administratio
 weight: 10
 ---
 
-With the right configurations, you can ensure your developers have easy access to necessary resources while preventing unauthorized access. This page guides you through identifying Docker users, so you can allocate subscription seats efficiently, and assigning roles to align with your organization's structure. 
+With the right configurations, you can ensure your developers have easy access to necessary resources while preventing unauthorized access. This page guides you through identifying Docker users, so you can allocate subscription seats efficiently within your Docker organization, and assigning roles to align with your organization's structure. 
 
-## Step one: Identify your Docker users and accounts
+## Step 1: Identify your Docker users and accounts
 
 Before setting up roles and permissions, it’s important to have a clear understanding of who in your organization requires Docker access. Focus on gathering a comprehensive view of active users, their roles within projects, and how they interact with Docker resources. This process can be supported by tools like device management software or manual assessments. Encourage all users to update their Docker accounts to use organizational email addresses, ensuring seamless integration with your subscription.
 
 For steps on how you can do this, see [step 1 of onboarding your organization](/manuals/admin/organization/onboard.md).
 
 ## Step 2: Assign roles strategically
 
+When you invite members to join you Docker organization, you assign them a role. 
+
 Docker’s predefined roles offer flexibility for various organizational needs. Assigning roles effectively ensures a balance of accessibility and security.
 
 - Member: Non-administrative role. Members can view other members that are in the same organization.