Cloud organizations revisions (#5244)

* copy tweak

* remove pro org convert content

* content updates

* remove images, update new images

* lint

* update broken integration urls

* Apply suggestions from code review

Co-authored-by: Ely Lucas <[email protected]>

* remove personal plan callout

* remove old images

* update ms teams callout

* fix image property

---------

Co-authored-by: Ely Lucas <[email protected]>

Author: jaffrepaul

docs/guides/cloud/organizations.mdx

@@ -3,22 +3,21 @@ title: Organizations
 sidebar_position: 70
 ---
 
-Organizations are used to group projects and manage access to those projects.
+:::info
 
-<DocsImage
-  src="/img/dashboard/organizations-listed-in-dashboard.png"
-  alt="Organizations"
-  width-600
-/>
+## <Icon name="graduation-cap" /> What you'll learn
+
+- What an Organization ID is and how it is useful
+- How to manage Organizations
+- How to apply for an Open Source (OSS) plan
 
-## Features
+:::
 
-- Create projects
-- Invite users
-- Transfer projects
-- Pay for all of your projects usage.
+Organizations are used to group and manage projects. Here you can create
+projects, manage users, access billing and usage information, leverage third
+party integrations, and apply org-level settings.
 
-### Organization ID
+## Organization ID
 
 An Organization's ID is a unique identifier in
 [UUID](https://tools.ietf.org/html/rfc4122) format that can be found under the
@@ -43,61 +42,22 @@ You can create an organization from within
 switcher and clicking **<Icon name="plus" /> Create new organization**.
 
 <DocsImage
-  src="/img/dashboard/create-org.png"
+  src="/img/guides/cloud/organizations/create-org.jpg"
   alt="Create new organization"
-  width-600
-/>
-
-<DocsImage
-  src="/img/dashboard/add-organization-dialog.png"
-  alt="Add Organization dialog"
-  width-600
-/>
-
-### Personal Org
-
-In the past, every user of Cypress was given a personal organization - named
-after you. You cannot delete or edit the name of this personal organization,
-however you can convert it to a professional organization.
-
-New users will no longer have a personal organization created for them
-automatically.
-
-#### Convert to professional org
-
-If you've already set up your projects, users, and billing on your personal
-organization, you can convert it to a professional organization via the
-**Organization settings** page.
-
-<DocsImage
-  src="/img/dashboard/convert-to-professional-org-button.jpg"
-  alt="Convert org for billing"
-/>
-
-Click the **Convert organization** button, provide a name for the organization,
-and hit **Convert organization**. This will do two things:
-
-1. It will upgrade your personal organization to a new named organization. All
-   of your projects, users, and billing information will carry over to this new
-   organization.
-2. We'll create a new, empty personal organization so you always have a place to
-   keep your side projects and experiments!
-
-<DocsImage
-  src="/img/dashboard/convert-to-professional-org-modal.jpg"
-  alt="Convert org to new org"
-  width-600
 />
 
 ### Delete Org
 
 You can delete organizations that you own as long as they do not have any
-projects in the organization. You must first transfer ownership of your projects
-to another organization before you can delete the organization.
+projects in the organization. You must first
+[delete](/guides/cloud/projects#Delete-Project) or
+[transfer ownership](/guides/cloud/projects#Transfer-ownership) of your projects
+your projects to another organization before you can delete the organization.
 
 <DocsImage
-  src="/img/dashboard/remove-organization-dialog.png"
+  src="/img/guides/cloud/organizations/remove-organization-dialog.jpg"
   alt="Delete Organization"
+  width="80%"
 />
 
 ## Billing & Usage
@@ -119,44 +79,37 @@ your Organization must meet the following criteria:
 
 ### Requesting OSS plan for an Org
 
-Follow the following process to request an OSS plan:
-
 1. [Login](https://on.cypress.io/dashboard) to the Cypress Dashboard, or
    [create an account](https://on.cypress.io/dashboard) if you are a new user.
 
-   <DocsImage
-     src="/img/dashboard/oss-plan-1-login.png"
-     alt="Login or Create Account"
-   />
-
 2. Go the [Organizations page](https://on.cypress.io/dashboard/organizations) to
    select the Organization you want to associate with an OSS plan. If you have
-   no Organizations, you can create one by clicking the **+ Add Organization**
-   button.
-
-:::tip
-
-**Note**: Personal organizations cannot be used with an OSS plan.
-
-:::
+   no Organizations, you can create one by clicking the **+ Create New
+   Organization** button.
 
-<DocsImage
-  src="/img/dashboard/oss-plan-2-select-org.png"
-  alt="Select or add organization"
-/>
+   <DocsImage
+     src="/img/guides/cloud/organizations/oss-plan-2-select-org.jpg"
+     alt="Select or add organization"
+     width="80%"
+   />
 
-3. Go to the **Billing & Usage** page, and then click on the **Apply for an open
-   source plan** link at the bottom of the page.
+3. Go to the **Billing & Usage** page, click **Upgrade** and then click on the
+   **Apply for an open source plan** link at the bottom of the page. _Note:
+   Access to all Projects must be set to **public** to enable this link._
 
    <DocsImage
-     src="/img/dashboard/oss-plan-3-billing.png"
+     src="/img/guides/cloud/organizations/oss-plan-3-billing.jpg"
+     alt="Upgrade Plan"
+   />
+   <DocsImage
+     src="/img/guides/cloud/organizations/oss-plan-4-billing.jpg"
      alt="Click Apply for an open source plan"
    />
 
 4. Fill in and submit the OSS plan request form.
 
    <DocsImage
-     src="/img/dashboard/oss-plan-4-apply.png"
+     src="/img/guides/cloud/organizations/oss-plan-5-billing.jpg"
      alt="OSS plan request form"
    />
 
@@ -169,11 +122,30 @@ If you have any questions regarding the OSS plan, please feel free
 
 ## Integrations
 
-- [BitBucket](/guides/cloud/integrations/bitbucket)
-- [GitHub](/guides/cloud/integrations/github)
-- [GitLab](/guides/cloud/integrations/gitlab)
-- [Jira](/guides/cloud/integrations/jira)
-- [Slack](/guides/cloud/integrations/slack)
+Owner and admin roles can integrate Cypress Cloud with many third party tools
+under **Organization > Integrations** and edit those settings from within the
+**Project settings** page.
+
+See our integration guides to learn more:
+
+### CI/CD
+
+<!-- prettier-ignore-start -->
+
+- &#8239;<Logo src="/img/logo/github.svg" /> [GitHub integration guide](/guides/cloud/integrations/github)
+- &#8239;<Logo src="/img/logo/gitlab.svg" /> [GitLab integration guide](/guides/cloud/integrations/gitlab)
+- &#8239;<Logo src="/img/logo/bitbucket.svg" /> [Bitbucket integration guide](/guides/cloud/integrations/bitbucket)
+
+### Project Management
+
+- &#8239;<Logo src="/img/logo/jira.svg" /> [Jira integration guide](/guides/cloud/integrations/jira)
+
+### Messaging
+
+- &#8239;<Logo src="/img/logo/slack.svg" /> [Cypress integration for Slack guide](/guides/cloud/integrations/slack)
+- &#8239;<Logo src="/img/logo/ms-teams.svg" /> [Cypress integration for Microsoft Teams guide](/guides/cloud/integrations/teams)
+
+<!-- prettier-ignore-end -->
 
 ### Enterprise SSO
 
@@ -202,12 +174,7 @@ Organization to set up SSO.
 
 1. Log in to Cypress Cloud and navigate to the **Integrations** page for your
    organization.
-   <DocsImage
-     src="/img/dashboard/organizations/integrations-nenu-screenshot.png"
-     alt="Enable SSO"
-     width-600
-   />
-1. Scroll down to the **Enterprise SSO** section. Select your SSO provider and
+2. Scroll down to the **Enterprise SSO** section. Select your SSO provider and
    take note of the information provided and required. Keep this window open and
    continue to the
    [configuration instructions for your specific SSO provider](#SSO-Provider-Configuration)
@@ -249,7 +216,7 @@ below, refer to
    <DocsImage
      src="/img/dashboard/organizations/okta-add-application-step3-cypress-sso.png"
      alt="Create Okta SAML App"
-     width-600
+     width={600}
    />
 1. Supply the following information requested in the Okta setup wizard:
 
@@ -330,8 +297,8 @@ addition to the documentation below, refer to the Microsoft Guides for
 
 #### Save Configuration
 
-1. Return to Cypress Cloud and click **Save Configuration**. Cypress Cloud will
-   attempt to authenticate.
+Return to Cypress Cloud and click **Save Configuration**. Cypress Cloud will
+attempt to authenticate.
 
 🎉 Your integration is now complete! You can invite all of the users in your
 organization to sign in through your SSO provider.