Docs for converting an account to an org and accessing an org (#9675)

Signed-off-by: Lena Larionova <lena.larionova@docker.com>

_data/toc.yaml

@@ -1446,9 +1446,9 @@ manuals:
         - path: /ee/ucp/authorization/pull-images/
           title: Allow users to pull images
         - path: /ee/ucp/authorization/ee-standard/
-          title: Access control design  
+          title: Access control design
         - path: /ee/ucp/authorization/ee-advanced/
-          title: Access control design using additional security requirements 
+          title: Access control design using additional security requirements
     - sectiontitle: Access UCP
       section:
       - path: /ee/ucp/user-access/
@@ -4007,6 +4007,8 @@ manuals:
     title: Official Images
   - path: /docker-hub/orgs/
     title: Teams & Organizations
+  - path: /docker-hub/convert-account/
+    title: Convert an account into an organization
   - path: /docker-hub/webhooks/
     title: Webhooks
   - path: /docker-hub/slack_integration/

docker-hub/convert-account.md

@@ -0,0 +1,30 @@
+---
+description: Convert your Docker Hub user account into an organization
+title: Convert an account into an organization
+keywords: docker hub, hub, organization
+---
+
+Besides directly [creating an organization from scratch](orgs/#create-an-organization), you can also convert an existing user account.
+
+You might want to do this if you need multiple users to access your account and the repositories that it's connected to. Converting it to an organization would give you better control over permissions for these users through teams.
+
+> Note: Once you convert your account, you can't revert it back, so make sure
+> you really want to do this!
+{: .warning }
+
+1. Remove the user account from all teams and organizations: go to **Organizations**, open an organization, then click the arrow next to your username in the members list.
+
+2. Click on your account name in the top navigation bar, then go to your **Account Settings**.
+
+3. Under the **Convert Account** tab, click **Convert to Organization**.
+
+    ![Convert account view](images/convert-account.png)
+
+4. Read the information carefully, as this cannot be undone and will have considerable implications for your assets and the account.
+
+5. As part of the conversion, you must set an organization owner. This is the user account that will manage the organization, and the *only* way to access the organization settings after conversion.
+
+    > **Note:** You cannot log into an organization directly. You must access
+    > it through an [owner or member account](orgs/#access-an-organization).
+
+6. Click **Convert**. You will get a success message with the new owner of the organization. Use that owner account to log into your new organization.

docker-hub/orgs.md

@@ -6,13 +6,13 @@ redirect_from:
 - /docker-cloud/orgs/
 ---
 
-Docker Hub Organizations let you create teams so you can give your team access
+Docker Hub organizations let you create teams so you can give your team access
 to shared image repositories.
 
 - **Organizations** are collections of teams and repositories that can be managed together.
 - **Teams** are groups of Docker Hub users that belong to an organization.
 
-> **Note**: in Docker Hub, users cannot belong directly to an organization.
+> **Note:** in Docker Hub, users cannot belong directly to an organization.
 They belong only to teams within an organization.
 
 ## Working with organizations
@@ -31,6 +31,8 @@ Docker Hub.
 You've created an organization. You'll see you have a team, the **owners** team
 with a single member (you!).
 
+In some situations, you can also create an organization by [converting a user account](/convert-account.md).
+
 #### The owners team
 
 The **owners** team is a special team that has full access to all repositories
@@ -41,6 +43,21 @@ Members of this team can:
 - Create a team and modify the membership of any team
 - Access and modify any repository belonging to the organization
 
+
+### Access an organization
+
+You can't _directly_ log into an organization. This is especially important to note if you create an organization by converting a user account, as conversion means you lose the ability to log into that "account", since it no longer exists.
+
+To access an organization:
+
+1. Log into Docker Hub with a user account that is a member of any team in the organization.
+
+    > If you want access to organization settings, this account has to be part of the **owners** team.
+
+2. Click **Organizations** in the top navigation bar, then choose your organization from the list.
+
+If you don't see the organization, then you are neither a member or an owner of it. An organization administrator will need to add you as a member of the organization team.
+
 ## Working with teams and members
 
 ### Create a team