licenses: document invite-time license assignment

content/manuals/admin/organization/manage/manage-licenses.md

@@ -1,48 +1,124 @@
 ---
 title: Manage license assignment
 linkTitle: License assignment
-description: Manage product licenses for your organization, including assignment, revocation, and automatic assignment.
-keywords: licenses, organization, members, Docker Core, Docker Offload, AI governance, license assignment, docker home
+description: Manage product licenses for your organization, including invite-time assignment, revocation, and automatic assignment.
+keywords: licenses, organization, members, invite, invitation, Docker Core, Docker Offload, AI Governance, license assignment, docker home
 weight: 30
 ---
 
-Licenses let you selectively choose which of your organization members have access to supported Docker products. Organization owners can oversee who on their team has active licenses, or configure licenses to assign automatically when members access supported Docker products. Like Docker Core seats, licenses can be configured on a per member basis.
+Licenses let you choose which organization members can access supported Docker
+products. Organization owners can manage active licenses for their members, or
+configure licenses to assign automatically when members access supported Docker
+products.
 
 > [!TIP]
-> To learn more about product licenses, Docker Core seats, and other Docker add-ons see [Docker plans](/manuals/subscription/plans/_index.md),
-> or <a href="https://www.docker.com/pricing/contact-sales/" id="dkr_docs_cs_admin_licenses" class="link" rel="noopener">contact sales</a> to purchase licenses.
+> To learn more about product licenses, Docker Core seats, and other Docker
+> add-ons, see [Docker plans](/manuals/subscription/plans/_index.md),
+> or
+> <a href="https://www.docker.com/pricing/contact-sales/" id="dkr_docs_cs_admin_licenses" class="link" rel="noopener">contact sales</a>
+> to purchase licenses.
 
-## Manage licenses
+## Licenses and invites
 
-The **Members** page lets you track the number of available licenses for your organization and who currently holds a license. You can also assign or revoke licenses from this page.
+When you invite someone, you can select a product license to assign when they
+accept. Docker doesn't reserve or deduct the license at invite time; assignment
+happens on acceptance:
 
-To manage licenses for your organization:
+- If a license is available when they accept, Docker assigns it to them and the
+  number of available licenses decreases by one.
+- If no licenses remain when they accept, they still join your organization,
+  but without a license.
 
-1. Sign in to [Docker Home](https://app.docker.com), then choose your organization.
-1. Select **Members** from the left navigation.
-1. Select the action menu at the end of the row to assign or revoke an active license.
-1. Optional. To bulk assign or revoke licenses, choose the members you want to bulk manage, then select the **Bulk actions** menu.
-1. Optional. To manage automatic license assignment, turn off or turn on with the **Automatically assign licenses** toggle.
+> [!NOTE]
+> Docker doesn't notify you or the invitee when a selected license is
+> unavailable at acceptance.
+
+Licenses aren't reserved for pending invitations, so they must still be
+available when each invitee accepts. Monitor availability on the Members page
+while invitations are pending.
+
+### Select licenses when inviting
+
+Selecting licenses when you invite is an alternative to assigning one manually
+after they join, or, where available, relying on automatic license assignment
+the first time they use a supported product. To select licenses when you invite
+a member:
+
+1. Sign in to [Docker Home](https://app.docker.com), then choose your
+   organization.
+1. Select **Members** from the left navigation, then select **Invite**.
+1. Select **Emails or usernames**.
+1. Enter the email addresses or Docker IDs of the people you want to invite,
+   then assign their
+   [role](/manuals/enterprise/security/roles-and-permissions/_index.md).
+1. Under **Licenses (optional)**, select one or more licenses that are
+   available to your organization.
+1. Select **Invite** to send the invite.
+
+For more about sending, resending, and removing invitations, including CSV
+file limits, see
+[Manage organization members](/manuals/admin/organization/manage/members.md).
 
-You must assign licenses manually, or configure automatic license assignment to consume a license. Inviting a new member to your organization consumes a seat or license if you select a product in **Licenses (optional)** during the [invite flow](/manuals/admin/organization/manage/members.md), but won't auto-assign product licenses by default. Conversely, purchasing a set of licenses won't trigger automatic assignment to existing members.
+### Accept invites
+
+A user can accept from the link in their invitation email or from their
+**Notifications Center**. If the selected license is available, Docker assigns
+it automatically upon acceptance.
 
 ## Automatic license assignment
 
-Automatic license assignment gives members a product license when they use a supported product for the first time. Automatic license assignment is available for AI Governance licenses. Only organizations that purchase AI Governance can set up auto-assignment for Docker Core as well.
+Automatic license assignment gives members a product license when they use a
+supported product for the first time. Automatic license assignment is available
+for AI Governance licenses. Only organizations that purchase AI Governance can
+set up auto-assignment for Docker Core as well.
 
-- When you purchase AI Governance, signing into [Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) with `login` command in `sbx` CLI (`sbx login`) automatically provisions AI Governance licenses on a first-come, first served basis.
-- Similarly, logins to Docker Desktop will automatically provision Docker Core for AI Governance license-holding organizations that have available Docker Core seats.
+- When you purchase AI Governance, signing in to
+  [Docker Sandboxes](/manuals/ai/sandboxes/_index.md) with the `sbx login`
+  command automatically provisions AI Governance licenses on a first-come,
+  first-served basis.
+- Similarly, signing in to Docker Desktop automatically provisions Docker Core
+  for AI Governance license-holding organizations that have available Docker
+  Core seats.
 - Licenses are assigned until exhausted.
-  - Once the available licenses are exhausted, automatic license assignment will stop until you purchase more licenses or revoke assigned licenses.
-  - Members can still use Docker Sandbox or Docker Desktop, but organization policies for those products won't affect their usage.
+  - Once the available licenses are exhausted, automatic license assignment
+    stops until you purchase more licenses or revoke assigned licenses.
+  - Members can still use Docker Sandboxes or Docker Desktop, but organization
+    policies for those products won't affect their usage.
+
+AI Governance licenses include single sign-on (SSO) and provisioning features
+regardless of your Docker Core subscription. Automatic license assignment
+requires
+[setting up SSO](/manuals/enterprise/security/single-sign-on/connect.md), then
+[provisioning](/manuals/enterprise/security/provisioning/_index.md) with System
+for Cross-domain Identity Management (SCIM) or Just-in-Time (JIT).
+
+## Manage licenses
 
-AI Governance licenses include single sign-on (SSO) and provisioning features regardless of your Docker Core subscription. Automatic license assignment requires [setting up SSO](/manuals/enterprise/security/single-sign-on/connect.md), then [provisioning](/manuals/enterprise/security/provisioning/_index.md) with System for Cross-domain Identity Management (SCIM) or Just-in-Time (JIT).
+The **Members** page lets you track the number of available licenses for your
+organization and who holds a license. You can also assign or revoke licenses
+from this page.
+
+To manage licenses for your organization:
+
+1. Sign in to [Docker Home](https://app.docker.com), then choose your
+   organization.
+1. Select **Members** from the left navigation.
+1. Select the action menu at the end of the row to assign or revoke an active
+   license.
+1. Optional. To bulk assign or revoke licenses, choose the members you want to
+   bulk manage, then select the **Bulk actions** menu.
+1. Optional. To manage automatic license assignment, turn off or turn on with
+   the **Automatically assign licenses** toggle.
 
 ## Next steps
 
-See these docs to explore Docker Core add-ons, or products that need licenses:
+Explore Docker Core add-ons and products that need licenses:
 
-- [Docker plans](/manuals/subscription/plans/_index.md) to learn about different add-ons
-- [Manage seats](/manuals/admin/organization/manage/manage-seats.md) to add more seats to your Docker Core subscription
-- [AI Governance](/manuals/ai/sandboxes/governance/org.md) to set up organization policies for your organization members
-- [Docker Offload](/manuals/offload/about.md) to let your developers offload building and running containers to the cloud
+- [Docker plans](/manuals/subscription/plans/_index.md) to learn about different
+  add-ons
+- [Manage seats](/manuals/admin/organization/manage/manage-seats.md) to add more
+  seats to your Docker Core subscription
+- [AI Governance](/manuals/ai/sandboxes/governance/org.md) to set up
+  organization policies for your organization members
+- [Docker Offload](/manuals/offload/about.md) to let your developers offload
+  building and running containers to the cloud

content/manuals/admin/organization/manage/members.md

@@ -2,14 +2,16 @@
 title: Manage organization members
 linkTitle: Members
 weight: 10
-description: Learn how to manage organization members.
-keywords: members, teams, organizations, invite members, manage team members, export member list, edit roles, organization teams, user management
+description: Manage organization members, including invitations, roles, teams,
+  and member-list exports.
+keywords: members, organization members, invitations, teams, manage team
+  members, export member list, edit roles, user management
 aliases:
   - /docker-hub/members/
   - /admin/organization/members/
 ---
 
-Learn how to manage members for your organization.
+Manage organization invitations, member roles, teams, and member-list exports.
 
 ## Invite members
 
@@ -19,6 +21,12 @@ Docker account, they must create one and verify their email address before
 they can accept an invitation to join the organization. When inviting members,
 their pending invitation occupies a seat.
 
+You can also select one or more product licenses for an invitee; Docker
+assigns available licenses when they accept. Unlike a seat, licenses aren't
+deducted from your organization's available licenses until the invitee accepts.
+See
+[Licenses and invites](/manuals/admin/organization/manage/manage-licenses.md#licenses-and-invites).
+
 ### Invite members via Docker ID or email address
 
 Use the following steps to invite members to your organization via Docker ID
@@ -35,8 +43,8 @@ When you invite members, you assign them a role. See
 [Roles and permissions](/manuals/enterprise/security/roles-and-permissions/_index.md)
 for details about the access permissions for each role.
 
-Pending invitations appear in the table. Invitees receive an email with a link
-to Docker Hub where they can accept or decline the invitation.
+Pending invitations appear in the table. Invitees can accept or decline the
+invitation from the invitation email or the **Notifications Center**.
 
 ### Invite members via CSV file
 
@@ -76,8 +84,8 @@ addresses:
    already members, or duplicated email addresses within the same CSV file.
 1. Follow the on-screen instructions to invite members.
 
-Pending invitations appear in the table. The invitees receive an email with a
-link to Docker Hub where they can accept or decline the invitation.
+Pending invitations appear in the table. Invitees can accept or decline the
+invitation from the invitation email or the **Notifications Center**.
 
 ### Invite members via API
 
@@ -87,10 +95,10 @@ API endpoint.
 
 ## Accept invitation
 
-After receiving an email invitation, users can access a link to Docker Hub
-where they can accept or decline the invitation.
+Users can accept or decline an invitation from the invitation email or the
+**Notifications Center**.
 
-To accept an invitation:
+To accept from the invitation email:
 
 1. Check your email inbox and open the Docker email with an invitation to
    join the Docker organization.
@@ -106,12 +114,17 @@ To accept an invitation:
    navigation menu.
 1. Select **Accept** on your invitation.
 
-After accepting an invitation, you are now a member of the organization.
+To accept from the **Notifications Center**:
+
+1. Sign in to [Docker Hub](https://hub.docker.com/) or
+   [Docker Home](https://app.docker.com/).
+1. Open the **Notifications Center** in the header.
+1. Select **Accept** on the invitation.
+
+After accepting an invitation, you become a member of the organization.
 
 Invitation email links expire after 14 days. If your email link has expired,
-you can sign in to [Docker Hub](https://hub.docker.com/) with the email
-address the link was sent to and accept the invitation from the
-**Notifications** panel.
+you can still accept from the **Notifications Center**.
 
 ## Manage invitations
 
@@ -121,7 +134,6 @@ file exceeds the number of available seats in your organization, you won't be
 able to invite more members.
 
 > [!TIP]
->
 > Need to manage more than 1,000 team members?
 > [Upgrade to Docker Business for unlimited user invites](https://www.docker.com/pricing?ref=Docs&refAction=DocsAdminMembers)
 > and advanced role management. You can also