Update the GitLab integration guide for Cloud

Author: stevenrombauts

Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-01-packagist-setup-20241219.png

@@ -1,28 +1,59 @@
 # GitLab (Self-Managed) Integration Setup
 ## Private Packagist Cloud
 
-## Initial Setup
+<div class="row column">
+    <div class="callout success">
+        <p>
+            This guide explains how to set up an OAuth integration for Private Packagist Cloud with the on-premises version of GitLab.
+            If you use their public service on GitLab.com, these instructions are not relevant to you. 
+        </p>
+        <p>If you are using our Self-Hosted product, please <a href="/docs/self-hosted/gitlab-integration-setup">use this guide</a>.</p>
+    </div>
+</div>
+
+To allow your users to authenticate to Private Packagist with their GitLab account, you'll first need to create
+an integration in Private Packagist. This document walks you through the required steps.
+
+## Open the Add Integration form
 
 From the organization settings page, select the "Integrations" subtab. Hit the "Add Integration" button on the integrations listing page to get to the form below.
-To set up a GitLab Self-Managed integration with Private Packagist, start by selecting "GitLab" as the plaform and enter the URL of your own GitLab server. A link to setup the OAuth application on your GitLab server will automatically be displayed.
+To set up a GitLab Self-Managed integration with Private Packagist, start by selecting "GitLab" as the platform and enter the URL of your own GitLab server. 
+A link to setup the OAuth application on your GitLab server will automatically be displayed.
 
-![Packagist Setup](/Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-01-packagist-setup.png)
+![Packagist Setup](/Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-01-packagist-setup-20241219.png)
 
 ## Add an OAuth Application
 
-Do not submit the integration form yet, but copy the content from the "Callback URL / Redirect URL" and follow the setup link to your GitLab server.
+Do not submit the integration form yet, but copy the content from the "Callback URL / Redirect URL" and follow the
+setup link to your GitLab server. The fields Client ID and Client Secret remain empty for now.
+
+On the GitLab applications page, click the "Add new application" button and fill in the form as shown here:
 
-![GitLab Form](/Resources/public/img/docs/integration-setup/gitlab-02-gitlab-form.png)
+![GitLab Form](/Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-02-gitlab-form.png)
 
-Make sure the "api" and "read_user" scopes are both checked and save the new application. This will reveal the credentials required to finish the setup on Private Packagist.
+Make sure the `api` and `read_user` scopes are both checked and save the new application. This will reveal the credentials required to finish the setup on Private Packagist.
 
 If you have full admin access on GitLab, then you can also create an application in the GitLab admin section under Applications.
-There are two additional checkmarks on that page: "trusted" should remain unchecked, and "confidential" should remain checked.
+There are two additional checkmarks on that page: `trusted` should remain unchecked, and `confidential` should remain checked.
 
-![GitLab Credentials](/Resources/public/img/docs/integration-setup/gitlab-03-gitlab-credentials.png)
+After you create the application, you will get a new Application ID and Secret. You'll need both these values to continue the set up in Private PackagisT.
+
+![GitLab Credentials](/Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-03-gitlab-credentials.png)
 
 ## Finish the Setup
 
 Copy and paste the "Application Id" and "Secret" value back into the Private Packagist integration form and submit the form with the "Save Integration" button.
 
-![GitLab Credentials](/Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-04-packagist-form.png)
+![Complete integration form](/Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-04-packagist-form-20241219.png)
+
+You'll be redirected back to the list of integrations.
+
+### Share the GitLab login link
+
+The final step is sharing your organization-specific login link with your users. Look for the "Login link" button next to
+your newly created GitLab integration on the integrations page, and copy the URL.
+
+![GitLab integration](/Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-05-integration.png)
+
+This link presents the option to authenticate with your GitLab account and can now be used to log in to Private Packagist. 
+

Resources/public/img/docs/integration-setup/cloud/gitlab-self-managed-01-packagist-setup.png

@@ -36,7 +36,7 @@ Instead of the user settings, you can also create an application in the settings
 have full admin access on GitLab in the GitLab admin section under Applications.
 There are two additional checkmarks on that page: `trusted` should remain unchecked, and `confidential` should remain checked.
 
-![GitLab Credentials](/Resources/public/img/docs/integration-setup/gitlab-03-gitlab-credentials.png)
+![GitLab Credentials](/Resources/public/img/docs/integration-setup/self-hosted/gitlab-03-gitlab-credentials.png)
 
 ## Create the integration
 Copy and paste the "Application Id" and "Secret" value back into the Private Packagist integration form and submit the form with the "Create Integration" button.