Updates to Subscription section

content/manuals/admin/company/manage/organizations.md

@@ -21,10 +21,9 @@ The **Organizations** view displays all organizations under your company.
 
 ## Add seats to an organization
 
-If you have a [self-serve](../../../subscription/details.md#self-serve)
-subscription that has no pending subscription changes, you can add seats using
-Docker Home. For more information about adding seats,
-see [Manage seats](/manuals/subscription/manage-seats.md#add-seats).
+If you have a self-serve subscription that has no pending subscription changes,
+you can add seats using Docker Home. For more information about adding seats,
+see [Manage seats](/manuals/subscription/manage-seats.md#add-seats-to-your-subscription).
 
 If you have a sales-assisted subscription, you must contact Docker support or
 sales to add seats.

content/manuals/subscription/change.md

@@ -1,5 +1,6 @@
 ---
 title: Change your subscription
+linkTitle: Upgrade or change
 description: Upgrade or downgrade your Docker subscription and understand billing changes
 keywords: upgrade subscription, downgrade subscription, docker pricing, subscription changes
 aliases:
@@ -13,7 +14,7 @@ aliases:
   - /docker-hub/billing/downgrade/
   - /billing/scout-billing/
   - /billing/subscription-management/
-weight: 30
+weight: 40
 ---
 
 You can upgrade or downgrade your Docker subscription at any time to match your changing needs. This page explains how to make subscription changes and what to expect with billing and feature access.
@@ -22,17 +23,21 @@ You can upgrade or downgrade your Docker subscription at any time to match your
 
 When you upgrade your Docker subscription, you immediately get access to all features and entitlements in your new subscription tier.
 
-For detailed feature information, see [Docker Pricing](https://www.docker.com/pricing?ref=Docs&refAction=DocsSubscriptionChange).
+> [!TIP]
+> If you're upgrading from a free Personal subscription to a Team subscription
+> and want to keep your username, [convert your user account into an organization](../admin/organization/setup/convert-account.md).
 
 To upgrade your subscription:
 
 1. Sign in to [Docker Home](https://app.docker.com/) and select the organization
    you want to upgrade.
-1. Select **Billing**.
-1. Optional. If you're upgrading from a free Personal subscription to a Team subscription and want to keep your username, [convert your user account into an organization](../admin/organization/setup/convert-account.md).
-1. Select **Upgrade**.
+1. Select **Billing** to view your current plans.
+1. Select **Browse products**.
+1. From the products catalog page, select **View plans** from the Docker tile. Choose a Docker Team or Business subscription for the organization.
 1. Follow the on-screen instructions to complete your upgrade. If you choose to pay using a US bank account, you must verify the account. For more information, see [Verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account).
 
+For detailed feature information, see [Docker Pricing](https://www.docker.com/pricing?ref=Docs&refAction=DocsSubscriptionChange).
+
 ## Downgrade your subscription
 
 You can downgrade your Docker subscription at any time before the renewal date. The unused portion isn't refundable, but you retain access to paid features until the next billing cycle.
@@ -52,7 +57,7 @@ To downgrade your subscription:
 1. Sign in to [Docker Home](https://app.docker.com/) and select
    the organization you want to downgrade.
 1. Select **Billing**.
-1. Select the action icon and then **Cancel subscription**.
+1. Select the action menu, then **Cancel subscription**.
 1. Fill out the feedback survey to continue with cancellation.
 
 > [!IMPORTANT]

content/manuals/subscription/desktop-license.md

@@ -2,7 +2,7 @@
 title: Docker Desktop license agreement
 description: Information about Docker Desktop's license agreement and commercial use requirements
 keywords: docker desktop license, subscription service agreement, commercial use, licensing terms
-weight: 40
+weight: 60
 ---
 
 Docker Desktop is licensed under the [Docker Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement). When you download and install Docker Desktop, you're asked to agree to these terms.

content/manuals/subscription/details.md

@@ -1,7 +1,8 @@
 ---
 title: Compare subscription
+linkTitle: Compare
 weight: 10
 params:
   sidebar:
     goto: "https://www.docker.com/pricing?ref=Docs&refAction=DocsSubscriptionDetails"
----
+---

content/manuals/subscription/faq.md

@@ -4,7 +4,7 @@ linkTitle: FAQs
 description: Frequently asked questions about Docker subscriptions and billing
 keywords: subscription faqs, docker billing, subscription transfer, academic pricing, docker programs
 tags: [FAQ]
-weight: 50
+weight: 70
 ---
 
 For more information on Docker subscriptions, see [Docker subscription overview](_index.md).  

content/manuals/subscription/manage-seats.md

@@ -10,7 +10,7 @@ aliases:
   - /subscription/remove-seats/
   - /subscription/core-subscription/add-seats/
   - /subscription/core-subscription/remove-seats/
-weight: 20
+weight: 50
 ---
 
 You can add or remove seats from your Docker Team or Business subscription at any time to accommodate team changes. When you add seats mid-billing cycle, you're charged a prorated amount for the additional seats.
@@ -28,12 +28,12 @@ To add seats:
 1. Select **Billing**.
    - If you choose to pay using a US bank account, you must verify the account.
    - For more information, see [Verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account).
-1. Select **Add seats** and follow the on-screen instructions to complete
-   adding seats.
+1. Select the action menu, then choose **Add seats**.
+1. Follow the on-screen instructions to complete adding seats.
    - You can't use pay by invoice for purchasing additional seats.
    - You must use a card or US bank account.
 
-You can now add more members to your organization. For more information, see [Manage organization members](../admin/organization/manage/members.md).
+You can add more members to your organization. For more information, see [Manage organization members](../admin/organization/manage/members.md).
 
 ## Volume pricing
 
@@ -50,7 +50,7 @@ If you have a sales-assisted Docker Business subscription, contact your account
 1. Sign in to [Docker Home](https://app.docker.com/) and select your
    organization.
 1. Select **Billing**.
-1. In the **Seats** row, select the action icon, then **Remove seats**.
+1. Select the action menu, then choose **Remove seats**.
 1. Follow the on-screen instructions to complete removing seats.
 
 You can cancel the removal of seats before your next billing cycle. To do so, select **Cancel change**.

content/manuals/subscription/scale.md

@@ -1,15 +1,18 @@
 ---
 title: Scale your subscription
+linkTitle: Scale
 description: Scale Docker Build Cloud and Testcontainers Cloud consumption for your subscription
 keywords: scale subscription, docker build cloud minutes, testcontainers cloud minutes, usage scaling
-weight: 17
+weight: 30
 ---
 
 Docker subscriptions let you scale consumption as your needs grow. All paid Docker subscriptions include base amounts of Docker Build Cloud build minutes and Testcontainers Cloud runtime minutes that you can supplement with additional capacity.
+
 You can scale consumption for:
 
 - Docker Build Cloud build minutes
 - Testcontainers Cloud runtime minutes
+- Docker Hardened Images (DHI) repositories with Docker Select
 
 To understand your usage patterns, [view your consumption](../admin/organization/manage/manage-products.md#monitor-product-usage-for-your-organization) at any time.
 
@@ -28,7 +31,7 @@ For example, with an annual Docker Team subscription (500 included minutes), if
 Purchase additional build minutes through the Docker Build Cloud Dashboard:
 
 1. Sign in to [Docker Home](https://app.docker.com/) and choose
-your organization.
+   your organization.
 1. Select **Build Cloud**, then **Build minutes**.
 1. Select **Add prepaid minutes**.
 1. Select your additional minute amount, then **Continue to payment**.
@@ -45,3 +48,15 @@ You can add Testcontainers Cloud runtime minutes in two ways:
 - Use unlimited runtime minutes on-demand with billing at the end of each monthly cycle
 
 On-demand usage is billed at higher rates than pre-purchased capacity. To avoid higher on-demand charges, pre-purchase additional minutes if you expect consistent usage over your subscription's included minutes.
+
+## Add repositories with Select
+
+To add more mirrored repositories to your Docker Select plan:
+
+1. Sign in to [Docker Home](https://app.docker.com/) and select your
+   organization.
+1. Select **Billing**.
+1. On the Overview page, select **Manage** next to **Hardened Images**.
+1. Select how many mirrored repositories the account can use.
+   - You can select between one and seven mirrors.
+   - For eight or more, [contact Docker sales](https://www.docker.com/pricing/contact-sales/) to discuss an Enterprise plan.

content/manuals/subscription/setup.md

@@ -2,7 +2,8 @@
 description: Set up Docker subscriptions for personal accounts and organizations
 keywords: subscription setup, docker pro, docker team, docker business, organization setup
 title: Set up your subscription
-weight: 15
+linkTitle: Setup
+weight: 20
 ---
 
 Docker subscriptions provide features and benefits for individual developers, teams, and enterprise businesses. This page explains how to set up subscriptions for personal accounts and organizations.
@@ -21,6 +22,25 @@ You can subscribe a new or existing organization to Docker Team or Business subs
 
 1. [Create your Docker ID](../accounts/create-account.md) if you don't already have one.
 1. [Create your organization](../admin/organization/setup/orgs.md) or use an existing organization you own.
-1. Choose and purchase a Docker Team or Business subscription for the organization.
+1. Select **Billing** to view your current plans, then select **Browse products**.
+1. From the products catalog page, select **View plans** from the Docker tile. Choose a Docker Team or Business subscription for the organization.
+1. Fill in plan entitlements, verify your billing details, then continue to payment to complete checkout.
 
-To upgrade an existing organization's subscription, see [Upgrade your subscription](./change.md#upgrade-your-subscription).
+## Set up Docker Select for an organization
+
+Docker Select lets organization admins assign Docker Hardened Images repositories to organization accounts. When you add repositories for your organization, all members gain access to the mirrored hardened image repositories. Members you add to the organization after setup inherit the same access.
+
+To purchase repositories with Docker Select, sign in to [Docker Home](https://app.docker.com/) and select your organization:
+
+1. Select **Billing**, then **Browse products**.
+1. Select **Hardened Images** from the products page.
+1. Select the organization account that should receive the **Hardened Images** entitlement, then **Continue**. You can add repositories for one account at a time.
+1. Select how many mirrored repositories the account can use.
+   - You can select between one and seven mirrors.
+   - For eight or more, [contact Docker sales](https://www.docker.com/pricing/contact-sales/) to discuss an Enterprise plan.
+1. Verify your billing details, continue to payment, and complete checkout.
+
+## What's next
+
+- To upgrade an existing organization's subscription, see [Upgrade your subscription](./change.md#upgrade-your-subscription).
+- To add more repositories to your Select plan, see [Add repositories with Select](./scale.md#add-repositories-with-select).