Update Bitbucket Self-Hosted docs

Author: stevenrombauts

Resources/public/img/docs/integration-setup/bitbucket-01-packagist-setup.png

@@ -2,32 +2,47 @@
 ## Private Packagist Self-Hosted
 
 <div class="row column">
-    <div class="callout warning">
-        <p>Note: The instructions on this page create an integration with the public Bitbucket at bitbucket.org. If you are trying to setup an integration with your own Bitbucket Data Center / Server consult the <a href="/docs/self-hosted/bitbucket-server-integration-setup.md">Bitbucket Data Center / Server setup guide</a>.</p>
+    <div class="callout success">
+        <p>This guide explains how to set up an OAuth integration for Private Packagist Self-Hosted with the public service on Bitbucket.org.</p>
+        <p>If you are trying to setup an integration with your own Bitbucket Data Center / Server, consult <a href="/docs/self-hosted/bitbucket-server-integration-setup.md">this guide for Self-Hosted</a>. If you are using our Cloud product at packagist.com, use <a href="/docs/cloud/bitbucket-server-integration-setup.md">this guide</a>.</p>
     </div>
 </div>
 
-## Initial Setup
-Hit the “Add Integration“ button on the admin page to get to the form below.
+To allow your users to authenticate to Private Packagist Self-Hosted with their Bitbucket 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
+Go to the Admin section and hit the “Add Integration“ button to open the form to create your integration. If you've just
+installed Private Packagist Self-Hosted and it is still running in Setup Mode, you do not need to log in. If the application
+is no longer in Setup mode, you will have to log in with an admin account first.
 
 ![Add Integration](/Resources/public/img/docs/self-hosted/08-integration-create.png)
 
 To setup a Bitbucket integration with Private Packagist start by selecting "Bitbucket" as the platform and enter <i>https://bitbucket.org</i> as the base URL, as seen in the example below.
+A link to set up the OAuth application on Bitbucket will automatically be displayed.
 
-![Packagist Setup](/Resources/public/img/docs/integration-setup/bitbucket-01-packagist-setup.png)
+![Packagist Setup](/Resources/public/img/docs/integration-setup/self-hosted/bitbucket-01-packagist-setup.png)
 
 ## Creating an OAuth Application
-Do not submit the integration form yet, but copy the content from the "Callback URL / Redirect URL" and go to <a href="https://bitbucket.org/account">https://bitbucket.org/account</a>. Find the "OAuth" menu item under "Access Management" and click on "Add consumer".
-
-![Bitbucket Form](/Resources/public/img/docs/integration-setup/bitbucket-02-bitbucket-form.png)
+Do not submit the integration form yet, the fields  Client ID and Client Secret remain empty for now. 
+Copy the content from the "Callback URL / Redirect URL" and open the setup link to your Bitbucket 
+account. Replace the `<WORKSPACE_NAME>` string in the setup link with your actual Bitbucket workspace name.
 
-Make sure all the scopes listed on the Private Packagist form are checked and save the new consumer.
+![Bitbucket Form](/Resources/public/img/docs/integration-setup/self-hosted/bitbucket-02-bitbucket-form.png)
 
-![Bitbucket Form](/Resources/public/img/docs/integration-setup/bitbucket-03-bitbucket-reveal-key.png)
+Make sure all the scopes listed on the Private Packagist form are checked and save the new consumer. Click on the consumer 
+you just created to reveal the credentials required to finish the setup on Private Packagist.
 
-Click on the consumer you just created to reveal the credentials required to finish the setup on Private Packagist.
+![Bitbucket Form](/Resources/public/img/docs/integration-setup/self-hosted/bitbucket-03-bitbucket-reveal-key.png)
 
 ## Finish the Setup
 Copy and paste the "Key" and "Secret" values back into the Private Packagist integration form and submit the form with the "Create Integration" button.
 
-![Bitbucket Form](/Resources/public/img/docs/integration-setup/bitbucket-04-packagist-form.png)
+![Bitbucket Form](/Resources/public/img/docs/integration-setup/self-hosted/bitbucket-04-packagist-form.png)
+
+The Bitbucket integration will be created and you will be redirected to the admin page.
+
+The new integration will be shown in the list of available integrations, and your users can
+now log in to your Private Packagist Self-Hosted installation using their Bitbucket account.
+
+![Available integrations](/Resources/public/img/docs/integration-setup/self-hosted/bitbucket-05-integrations-overview.png)