edits

Author: aevesdocker

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

@@ -1,5 +1,5 @@
 ---
-title: Mastering Docker user and access management
+title: Mastering user and access management
 summary: Simplify user access while ensuring security and efficiency in Docker.
 description: A guide for managing roles, provisioning users, and optimizing Docker access with tools like SSO and activity logs.
 tags: [admin]
@@ -22,7 +22,7 @@ params:
       url: /admin/organization/activity-logs/
 ---
 
-Managing roles and permissions is key to securing your Docker environment while enabling seamless collaboration and operational efficiency. This guide walks IT administrators through the essentials of user and access management, offering strategies for assigning roles, provisioning users, and leveraging tools like activity logs and insights to monitor and optimize Docker usage.
+Managing roles and permissions is key to securing your Docker environment while enabling easy collaboration and operational efficiency. This guide walks IT administrators through the essentials of user and access management, offering strategies for assigning roles, provisioning users, and using tools like Activity logs and Insights to monitor and optimize Docker usage.
 
 ## Who's this for?
 
@@ -35,7 +35,7 @@ Managing roles and permissions is key to securing your Docker environment while
 - How to assess and manage Docker user access and align accounts with organizational needs.
 - When to use team configurations for scalable access control.
 - How to automate and streamline user provisioning with SSO, SCIM, and JIT.
-- How monitoring tools like audit logs can bolster compliance.
+- How to get the most out of Docker's monitoring tools.
 
 ## Tools integration 
 

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

@@ -5,20 +5,20 @@ keywords: organizational insights, user management, access control, security, mo
 weight: 30
 ---
 
-Activity logs and insights are essential for user and access management in Docker. They provide visibility into user actions, team workflows, and organizational trends, helping enhance security, ensure compliance, and boost productivity.
+Activity logs and Insights are useful tools for user and access management in Docker. They provide visibility into user actions, team workflows, and organizational trends, helping enhance security, ensure compliance, and boost productivity.
 
 ## Activity logs
 
 Activity logs track events at the organization and repository levels, offering a clear view of activities like repository changes, team updates, and billing adjustments.
 
+It is available for Docker Team or Docker Business plans, with data retained for three months.
+
 ### Key features
 
  - Change tracking: View what changed, who made the change, and when.
 
  - Comprehensive reporting: Monitor critical events such as repository creation, deletion, privacy changes, and role assignments.
 
- - Requirements: Available for Docker Team or Docker Business plans, with data retained for three months.
-
 ### Example scenarios
 
  - Audit trail for security: A repository’s privacy settings were updated unexpectedly. The activity logs reveal which user made the change and when, helping administrators address potential security risks.

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

@@ -1,21 +1,15 @@
 ---
-title: Onboarding and managing roles and ermissions in Docker
+title: Onboarding and managing roles and permissions in Docker
 description: Learn how to manage roles, invite members, and implement scalable access control in Docker for secure and efficient collaboration.
 keywords: sso, scim, jit, invite members, docker hub, docker admin console, onboarding, security
 weight: 20
 ---
 
-Learn how to invite owners, add members, and implement advanced tools like SSO and SCIM for secure and efficient access control when onboarding your organization and developers.
+This page guides you through onboarding owners and members, and using tools like SSO and SCIM to future-proof onboarding going forward.
 
 ## 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.
-
-### Why add owners?
-
- - Shared responsibilities: Distribute administrative tasks, such as managing roles and permissions.
-
- - Improved continuity: Ensure seamless operations in case the primary owner 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 own is unavailable.
 
 For detailed information on owners, see [Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md)
 

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

@@ -5,7 +5,7 @@ keywords: Docker roles, permissions management, access control, IT administratio
 weight: 10
 ---
 
-Managing roles and permissions is a fundamental aspect of maintaining security, collaboration, and operational efficiency in Docker. With the right configurations, IT administrators can ensure developers have seamless access to necessary resources while preventing unauthorized access. This guide is tailored to help you identify Docker users, allocate subscription seats efficiently, and strategically assign roles to align with your organization's structure. By following these steps, you can enhance productivity and maintain robust access control.
+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. 
 
 ## Step one: Identify your Docker users and accounts
 
@@ -46,6 +46,6 @@ For more information, see [Create and manage a team](/manuals/admin/organization
 
 ### Best practices
 
-- Apply the principle of least privilege: Assign users only the minimum permissions necessary for their roles.
+- Apply the principle of least privilege. Assign users only the minimum permissions necessary for their roles.
 
-- Conduct regular audits: Plan to conduct regulars reviews of role assignments to ensure they align with evolving team structures and organizational responsibilities.
+- Plan to conduct regulars reviews of role assignments to ensure they align with evolving team structures and organizational responsibilities.