publish updates from main (#22917)

Automated pull request for publishing docs updates.

---------

Signed-off-by: Paweł Gronowski <[email protected]>
Signed-off-by: Craig <[email protected]>
Co-authored-by: Guillaume Lours <[email protected]>
Co-authored-by: Esteban Maya <[email protected]>
Co-authored-by: Sarah Sanders <[email protected]>
Co-authored-by: Paweł Gronowski <[email protected]>
Co-authored-by: Nick Santos <[email protected]>
Co-authored-by: Arthur <[email protected]>
Co-authored-by: Craig Osterhout <[email protected]>
Co-authored-by: Allie Sadler <[email protected]>

Author: 8 people

_vale/Docker/Acronyms.yml

@@ -146,6 +146,7 @@ exceptions:
   - TTY
   - TXT
   - UDP
+  - UI
   - URI
   - URL
   - USB

_vale/config/vocabularies/Docker/accept.txt

@@ -133,6 +133,7 @@ rootful
 runc
 Ryuk
 S3
+scrollable
 Slack
 snapshotters?
 Snyk

content/contribute/ui.md

@@ -1,45 +1,73 @@
 ---
 title: UI elements in content
-description: How to refer and interact with UI content
-keywords: ui, contribute, style guide
+description: How to refer to and write about UI elements in technical documentation.
+keywords: ui, contribute, style guide, docker docs
 weight: 40
 ---
 
-This page contains information on how to write technical content that involves a user interface (UI).
+Use this guide when writing documentation that refers to buttons, fields, menus, dialogs, or other user interface (UI) elements. It explains how to format UI terms, write task-focused instructions, and refer to common UI patterns consistently and clearly.
 
-## Format names of UI elements
+## Format UI element names
 
-Always bold UI elements when referring to them by name.
+Use bold formatting for the visible names of UI elements:
 
-This includes names for buttons, menus, dialogs, windows, list items, or any other feature on the page that has a visible name.
+- Buttons  
+- Dialogs  
+- Windows  
+- Tabs  
+- Menu items  
+- List items  
+- Form labels  
+- Section headings
 
-Don't make an official feature name or product name bold, except when it directly refers to an element on the page that uses the name, such as a window title or button name.
+For example: 
 
-In most cases, follow the capitalization as it appears on the page. However, if labels are inconsistent or they're all uppercase, use sentence case.
+*Select **Create**, then fill out the **Name** field.*
 
-## Focus on the task
+Do not bold product names or features unless they appear exactly as a label in the UI.
 
-When practical, state instructions in terms of what the user should accomplish, rather than focusing on the widgets and gestures. By avoiding reference to UI elements, you help the user understand the purpose of an instruction, and it can help future-proof procedures.
+### Capitalization
 
-|Correct     |Incorrect    |
-|:-----------|:------------|
-|Expand the **Advanced options** section | Select the zippy to expand the **Advanced options** section|
+- Follow the capitalization as it appears in the UI.
+- If UI labels are all uppercase or inconsistent, use sentence case in your docs for readability.
 
+## Write task-focused instructions
 
-## Refer to UI elements
+When possible, guide users based on what they’re trying to do, not just what they should select. This makes docs more goal-oriented and adaptable to UI changes.
 
-Don't use UI elements as if they were English verbs or nouns.
+| Do this                        | Avoid this                             |
+|----------------------------------|-------------------------------------------|
+| Expand the **Advanced options** section. | Select the zippy to expand the **Advanced options** section. |
+| Choose a base image for your container. | Select a dropdown and pick something.    |
 
-|Correct     |Incorrect    |
-|:-----------|:------------|
-|In the **Name** field, enter an account name. | **Name** the account.|
-|To save the settings, select **Save**.| **Save** the settings.|
 
-## Prepositions
+## Use correct prepositions with UI elements
 
-When documenting the UI, use the following prepositions. 
+Choose the right preposition based on the type of UI element you're referencing.
 
-|Preposition   |UI element   |  Example |
-|:-----------|:------------|:-----------|
-|in          | dialogs <br>fields <br>lists <br>menus <br>panes <br>windows <br>| In the **Alert** dialog, select **OK**. <br> In the **Name** field, enter `wsfc-1`. <br> In the **Item** list, select **Desktop**. <br>In the **File** menu, click **Tools**.<br> In the **Metrics** pane, select **New**. <br>In the **Task** window, select **Start**. |
-| on         |pages <br>tabs <br>toolbars | On the **Create an instance** page, select **Add**. <br> On the **Edit** tab, select **Save**.<br> On the **Dashboard toolbar**, select **Edit**.<br>|
+| Preposition | Use with...                    | Example |
+|-------------|--------------------------------|---------|
+| **in**      | dialogs, fields, lists, menus, panes, windows | In the **Name** field, enter your project name. |
+| **on**      | pages, tabs, toolbars          | On the **Settings** tab, select **General**. |
+
+
+## Use consistent UI element terms
+
+Use these standard terms when referring to elements in Docker products:
+
+| Preferred Term      | Use When Referring To...                     |
+|---------------------|----------------------------------------------|
+| **button**          | A clickable action element (e.g., **Start**) |
+| **field**           | A place to enter text or select a value      |
+| **menu** / **menu item** | A drop-down or navigation option         |
+| **drop-down**       | A drop-down menu  item                             |
+| **context switcher** | Specific to toggling on cloud mode          |
+| **tab**             | A selectable view within a window or page    |
+| **dialog**          | A popup window for confirmations or options  |
+| **section**         | A logical grouping of content on a page      |
+| **list** / **list item** | A scrollable list of selectable entries |
+| **toggle**  | A binary control (on/off)               |
+| **checkbox**        | A multi-select control                      |
+| **tooltip**         | Text that appears on hover                  |
+
+Finally, instead of saying “click the control,” say “select the **Create** button.”

content/manuals/accounts/deactivate-user-account.md

@@ -17,10 +17,11 @@ Before deactivating your Docker account, ensure you meet the following requireme
 
 - For owners, you must leave your organization or company before deactivating your Docker account.
     To do this:
-    1. Sign in to the [Docker Admin Console](https://app.docker.com/admin).
-    2. Select the organization you need to leave from the **Choose profile** page.
-    3. Find your username in the **Members** tab.
-    4. Select the **More options** menu and then select **Leave organization**.
+    1. Sign in to [Docker Home](https://app.docker.com/admin) and choose
+    your organization.
+    1. Select **Admin Console**.
+    1. Select **Members** and find your username.
+    1. Select the **Actions** menu and then select **Leave organization**.
 
 - If you are the sole owner of an organization, you must assign the owner role to another member of the organization and then remove yourself from the organization, or deactivate the organization. Similarly, if you are the sole owner of a company, either add someone else as a company owner and then remove yourself, or deactivate the company.
 
@@ -39,8 +40,8 @@ Once you have completed all the previous steps, you can deactivate your account.
 > This cannot be undone. Be sure you've gathered all the data you need from your account before deactivating it.
 
 1. Sign in to [Docker Home](https://app.docker.com/login).
-2. Select your avatar to open the drop-down menu.
-3. Select **Account settings**.
-4. Select **Deactivate**.
-5. Select **Deactivate account**.
-6. To confirm, select **Deactivate account**.
+1. Select your avatar to open the drop-down menu.
+1. Select **Account settings**.
+1. Select **Deactivate**.
+1. Select **Deactivate account**.
+1. To confirm, select **Deactivate account**.

content/manuals/accounts/manage-account.md

@@ -18,9 +18,7 @@ account security.
 ## Update general settings
 
 1. Sign in to your [Docker account](https://app.docker.com/login).
-2. In Docker Home, select your avatar in the top-right corner to open the
-drop-down.
-3. Select **Account settings**.
+2. Select your avatar in the top-right corner and select **Account settings**.
 
 From the Account settings page, you can take any of the following actions.
 

content/manuals/admin/_index.md

@@ -37,7 +37,7 @@ aliases:
 
 Administrators can manage companies and organizations using the Docker Admin Console.
 
-The [Docker Admin Console](https://admin.docker.com) provides administrators with centralized observability, access management, and controls for their company and organizations. To provide these features, Docker uses the following hierarchy and roles.
+The [Docker Admin Console](https://app.docker.com/admin) provides administrators with centralized observability, access management, and controls for their company and organizations. To provide these features, Docker uses the following hierarchy and roles.
 
 ![Docker hierarchy](./images/docker-admin-structure.webp)
 

content/manuals/admin/company/_index.md

@@ -33,7 +33,7 @@ grid:
 - title: Domain management
   description: Add and verify your domains.
   icon: domain_verification
-  link: /admin/company/settings/domains/
+  link: /security/for-admins/domain-management/
 - title: FAQs
   description: Explore common company FAQs.
   link: /faq/admin/company-faqs/

content/manuals/admin/company/new-company.md

@@ -16,17 +16,17 @@ You can create a new company in the Docker Admin Console. Before you begin, you
 
 To create a new company:
 
-1. Sign in to the [Admin Console](https://app.docker.com/admin).
-2. Select your organization you want to add to your company from the **Choose profile** page.
-3. Under **Organization settings**, select **Company management**.
-4. Select **Create a company**.
-5. Enter a unique name for your company, then select **Continue**.
+1. Sign in to [Docker Home](https://app.docker.com/) and select your
+organization.
+1. Select **Admin Console**, then **Company management**.
+1. Select **Create a company**.
+1. Enter a unique name for your company, then select **Continue**.
 
     > [!TIP]
     >
     > The name for your company can't be the same as an existing user, organization, or company namespace.
 
-6. Review the company migration details and then select **Create company**.
+1. Review the company migration details and then select **Create company**.
 
 For more information on how you can add organizations to your company, see [Add organizations to a company](./organizations.md#add-organizations-to-a-company).
 

content/manuals/admin/company/organizations.md

@@ -10,11 +10,11 @@ You can manage the organizations in a company in the Docker Admin Console.
 
 ## View all organizations
 
-1. Sign in to the [Admin Console](https://admin.docker.com).
-2. Select your company on the **Choose profile** page.
-3. Under **Organizations**, select **Overview**.
+1. Sign in to the [Docker Home](https://app.docker.com) and choose
+your company.
+1. Select **Admin Console**, then **Organizations**.
 
-The organization overview page displays all organizations under your company.
+The **Organizations** view displays all organizations under your company.
 
 ## Add seats to an organization
 
@@ -30,18 +30,17 @@ You must be a company owner to add an organization to a company. You must also b
 >
 > Once you add an organization to a company, you can't remove it from the company.
 
-1. Sign in to the [Admin Console](https://admin.docker.com).
-2. Select your company on the **Choose profile** page.
-3. Select **Organizations**, then **Overview**.
-4. Select **Add organization**.
-5. Choose the organization you want to add from the drop-down menu.
-6. Select **Add organization** to confirm.
+1. Sign in to [Docker Home](https://app.docker.com) and select your company.
+1. Select **Admin Console**, then **Organizations**.
+1. Select **Add organization**.
+1. Choose the organization you want to add from the drop-down menu.
+1. Select **Add organization** to confirm.
 
 ## Manage an organization
 
-1. Sign in to the [Admin Console](https://admin.docker.com).
-2. Select your company on the **Choose profile** page.
-3. Select the organization that you want to manage.
+1. Sign in to [Docker Home](https://app.docker.com) and select your company.
+1. Select **Admin Console**, then **Organizations**.
+1. Select the organization you want to manage.
 
 For more details about managing an organization, see [Organization administration](../organization/_index.md).
 

content/manuals/admin/company/owners.md

@@ -23,17 +23,15 @@ owners don't need to be member of an organization.
 
 ## Add a company owner
 
-1. Sign in to the [Admin Console](https://admin.docker.com).
-2. Select your company on the **Choose profile** page.
-3. Select **Company owners**.
-4. Select **Add owner**.
-5. Specify the user's Docker ID to search for the user.
-6. After you find the user, select **Add company owner**.
+1. Sign in to [Docker Home](https://app.docker.com) and select your company.
+1. Select **Admin Console**, then **Company owners**.
+1. Select **Add owner**.
+1. Specify the user's Docker ID to search for the user.
+1. After you find the user, select **Add company owner**.
 
 ## Remove a company owner
 
-1. Sign in to the [Admin Console](https://admin.docker.com).
-2. Select your company on the **Choose profile** page.
-3. Select **Company owners**.
-4. Select the **Action** icon in the row of the company owner that your want to remove.
-5. Select **Remove as company owner**.
+1. Sign in to [Docker Home](https://app.docker.com) and select your company.
+1. Select **Admin Console**, then **Company owners**.
+1. Locate the company owner you want to remove and select the **Actions** menu.
+1. Select **Remove as company owner**.