add onboard.md freshness

sarahsanders-docker · sarahsanders-docker · commit 8186e4055400 · 2025-06-30T15:27:40.000-04:00
diff --git a/content/manuals/admin/organization/onboard.md b/content/manuals/admin/organization/onboard.md
@@ -2,7 +2,7 @@
 title: Onboard your organization
 weight: 20
 description: Get started onboarding your Docker Team or Business organization.
-keywords: business, team, organizations, get started, onboarding
+keywords: business, team, organizations, get started, onboarding, Admin Console, organization management,
 toc_min: 1
 toc_max: 3
 aliases:
@@ -13,33 +13,40 @@ aliases:
 
 {{< summary-bar feature_name="Admin orgs" >}}
 
-Learn how to onboard your organization using Docker Hub or the Docker Admin Console.
+Learn how to onboard your organization using the Admin Console or Docker Hub.
 
-Onboarding your organization lets administrators gain visibility into user activity and enforce security settings. In addition, members of your organization receive increased pull limits and other organization wide benefits. For more details, see [Docker subscriptions and features](../../subscription/details.md).
+Onboarding your organization includes:
 
-In this guide, you'll learn how to do the following:
-
-- Identify your users to help you efficiently allocate your subscription seats
+- Identifying users to help you allocate your subscription seats
 - Invite members and owners to your organization
-- Secure authentication and authorization for your organization using Single Sign-On (SSO) and System for Cross-domain Identity Management (SCIM)
-- Enforce sign-on for Docker Desktop to ensure security best practices
+- Secure authentication and authorization for your organization
+- Enforce sign-in for Docker Desktop to ensure security best practices
+
+These actions help administrators gain visibility into user activity and
+enforce security settings. Organization memebers also receive increased pull
+limits and other benefits when they are signed in.
 
 ## Prerequisites
 
-Before you start onboarding your organization, ensure that you:
+Before you start onboarding your organization, ensure you:
 
-- Have a Docker Team or Business subscription. See [Docker Pricing](https://www.docker.com/pricing/) for details.
+- Have a Docker Team or Business subscription. For more details, see
+[Docker subscriptions and features](/manuals/subscription/details.md).
 
   > [!NOTE]
   >
-  > When purchasing a self-serve subscription, the on-screen instructions guide you through creating an organization. If you have purchased a subscription through Docker Sales and you have not yet created an organization, see [Create an organization](/admin/organization/orgs).
+  > When purchasing a self-serve subscription, the on-screen instructions
+  guide you through creating an organization. If you have purchased a
+  subscription through Docker Sales and you have not yet created an
+  organization, see [Create an organization](/manuals/admin/organization/orgs.md).
 
-- Familiarize yourself with Docker concepts and terminology in the [administration overview](../_index.md) and [FAQs](/faq/admin/general-faqs/).
+- Familiarize yourself with Docker concepts and terminology in
+the [administration overview](../_index.md).
 
 ## Onboard with guided setup
 
-The Admin Console has a guided setup to help you easily
-onboard your organization. The guided setup steps consist of basic onboarding
+The Admin Console has a guided setup to help you
+onboard your organization. The guided setup's steps consist of basic onboarding
 tasks. If you want to onboard outside of the guided setup,
 see [Recommended onboarding steps](/manuals/admin/organization/onboard.md#recommended-onboarding-steps).
 
@@ -52,8 +59,8 @@ The guided setup walks you through the following onboarding steps:
 - **Invite your team**: Invite owners and members.
 - **Manage user access**: Add and verify a domain, manage users with SSO, and
 enforce Docker Desktop sign-in.
-- **Docker Desktop security**: Configure image access management, registry access
-management, and settings management.
+- **Docker Desktop security**: Configure image access management, registry
+access management, and settings management.
 
 ## Recommended onboarding steps
 
@@ -63,56 +70,93 @@ Identifying your users helps you allocate seats efficiently and ensures they
 receive your Docker subscription benefits.
 
 1. Identify the Docker users in your organization.
-   - If your organization uses device management software, like MDM or Jamf, you can use the device management software to help identify Docker users. See your device management software's documentation for details. You can identify Docker users by checking if Docker Desktop is installed at the following location on each user's machine:
+   - If your organization uses device management software, like MDM or Jamf,
+   you can use the device management software to help identify Docker users.
+   See your device management software's documentation for details. You can
+   identify Docker users by checking if Docker Desktop is installed at the
+   following location on each user's machine:
       - Mac: `/Applications/Docker.app`
       - Windows: `C:\Program Files\Docker\Docker`
       - Linux: `/opt/docker-desktop`
-   - If your organization doesn't use device management software or your users haven't installed Docker Desktop yet, you can survey your users.
-2. Ask users to update their Docker account email to one in your organization’s domain, or create a new account with that email.
-   - To update an account's email address, instruct your users to sign in to [Docker Hub](https://hub.docker.com), and update the email address to their email address in your organization's domain.
-   - To create a new account, instruct your users to go [sign up](https://hub.docker.com/signup) using their email address in your organization's domain.
-3. Ask your Docker sales representative or [contact sales](https://www.docker.com/pricing/contact-sales/) to get a list of Docker accounts that use an email address in your organization's domain.
+   - If your organization doesn't use device management software or your
+   users haven't installed Docker Desktop yet, you can survey your users to
+   identify who is using Docker Desktop.
+2. Ask users to update their Docker account's email address to one associated
+with your organization's domain, or create a new account with that email.
+   - To update an account's email address, instruct your users to sign in
+   to [Docker Hub](https://hub.docker.com), and update the email address to
+   their email address in your organization's domain.
+   - To create a new account, instruct your users to
+   [sign up](https://hub.docker.com/signup) using their email address associated
+   with your organization's domain.
+3. Identify Docker accounts associated with your organization's domain:
+   - Ask your Docker sales representative or
+   [contact sales](https://www.docker.com/pricing/contact-sales/) to get a list
+   of Docker accounts that use an email address in your organization's domain.
+   - Use [domain audit](/manuals/security/for-admins/domain-audit.md) to
+   identify uncapture users in your organization.
 
 ### Step two: Invite owners
 
-When you create an organization, you are the only owner. It is optional to add additional owners. Owners can help you onboard and manage your organization.
+Owners can help you onboard and manage your organization.
+
+When you create an organization, you are the only owner. It is optional to
+add additional owners.
 
-To add an owner, invite a user and assign them the owner role. For more details, see [Invite members](/admin/organization/members/).
+To add an owner, invite a user and assign them the owner role. For more
+details, see [Invite members](/manuals/admin/organization/members.md) and
+[Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md).
 
 ### Step three: Invite members
 
-When you add users to your organization, you gain visibility into their activity and you can enforce security settings. In addition, members of your organization receive increased pull limits and other organization wide benefits.
+When you add users to your organization, you gain visibility into their
+activity and you can enforce security settings. Your members also
+receive increased pull limits and other organization wide benefits when
+they are signed in.
 
-To add a member, invite a user and assign them the member role. For more details, see [Invite members](/admin/organization/members/).
+To add a member, invite a user and assign them the member role.
+For more details, see [Invite members](/manuals/admin/organization/members.md) and
+[Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md).
 
 ### Step four: Manage user access with SSO and SCIM
 
-Configuring SSO and SCIM is optional and only available to Docker Business subscribers. To upgrade a Docker Team subscription to a Docker Business subscription, see [Upgrade your subscription](/subscription/upgrade/).
+Configuring SSO and SCIM is optional and only available to Docker Business
+subscribers. To upgrade a Docker Team subscription to a Docker Business
+subscription, see [Change your subscription](/manuals/subscription/change.md).
 
 Use your identity provider (IdP) to manage members and provision them to Docker
 automatically via SSO and SCIM. See the following for more details:
 
-   - [Configure SSO](/manuals/security/for-admins/single-sign-on/configure.md) to authenticate and add members when they sign in to Docker through your identity provider.
-   - Optional. [Enforce SSO](/manuals/security/for-admins/single-sign-on/connect.md) to ensure that when users sign in to Docker, they must use SSO.
+   - [Configure SSO](/manuals/security/for-admins/single-sign-on/configure.md)
+   to authenticate and add members when they sign in to Docker through your
+   identity provider.
+   - Optional.
+   [Enforce SSO](/manuals/security/for-admins/single-sign-on/connect.md) to
+   ensure that when users sign in to Docker, they must use SSO.
 
      > [!NOTE]
      >
      > Enforcing single sign-on (SSO) and enforcing Docker Desktop sign in
      are different features. For more details, see
-     > [Enforcing sign-in versus enforcing single sign-on (SSO)](/security/for-admins/enforce-sign-in/#enforcing-sign-in-versus-enforcing-single-sign-on-sso).
+     > [Enforcing sign-in versus enforcing single sign-on (SSO)](/manuals/security/for-admins/enforce-sign-in.md#enforcing-sign-in-versus-enforcing-single-sign-on-sso).
 
-   - [Configure SCIM](/security/for-admins/provisioning/scim/) to automatically provision, add, and de-provision members to Docker through your identity provider.
+   - [Configure SCIM](/manuals/security/for-admins/provisioning/scim.md) to
+   automatically provision, add, and de-provision members to Docker through
+   your identity provider.
 
 ### Step five: Enforce sign-in for Docker Desktop
 
 By default, members of your organization can use Docker Desktop without signing
 in. When users don’t sign in as a member of your organization, they don’t
-receive the [benefits of your organization’s subscription](../../subscription/details.md) and they can circumvent [Docker’s security features](/security/for-admins/hardened-desktop/).
+receive the
+[benefits of your organization’s subscription](../../subscription/details.md)
+and they can circumvent [Docker’s security features](/manuals/security/for-admins/hardened-desktop/_index.md).
 
-There are multiple ways you can enforce sign-in, depending on your company's setup and preferences:
-- [Registry key method (Windows only)](/security/for-admins/enforce-sign-in/methods/#registry-key-method-windows-only)
-- [`.plist` method (Mac only)](/security/for-admins/enforce-sign-in/methods/#plist-method-mac-only)
-- [`registry.json` method (All)](/security/for-admins/enforce-sign-in/methods/#registryjson-method-all)
+There are multiple ways you can enforce sign-in, depending on your organization's
+Docker configuration:
+- [Registry key method (Windows only)](/manuals/security/for-admins/enforce-sign-in/methods.md#registry-key-method-windows-only)
+- [`.plist` method (Mac only)](/manuals/security/for-admins/enforce-sign-in/methods.md#plist-method-mac-only)
+- [`registry.json` method (All)](/manuals/security/for-admins/enforce-sign-in/methods.md#registryjson-method-all)
 
 ### Step six: Manage Docker Desktop security
 
@@ -125,8 +169,12 @@ security posture:
 
 ## What's next
 
-- [Manage Docker products](./manage-products.md) to configure access and view usage.
-- Configure [Hardened Docker Desktop](/desktop/hardened-desktop/) to improve your organization’s security posture for containerized development.
-- [Audit your domains](/docker-hub/domain-audit/) to ensure that all Docker users in your domain are part of your organization.
+- [Manage Docker products](./manage-products.md) to configure access and view
+usage.
+- Configure [Hardened Docker Desktop](/desktop/hardened-desktop/) to improve
+your organization’s security posture for containerized development.
+- [Audit your domains](/docker-hub/domain-audit/) to ensure that all Docker
+users in your domain are part of your organization.
 
-Your Docker subscription provides many more additional features. To learn more, see [Docker subscriptions and features](/subscription/details/).
+Your Docker subscription provides many more additional features. To learn more,
+see [Docker subscriptions and features](/subscription/details/).
