[docs] native gitlab

Author: svenefftinge

src/docs/gitlab-integration.md

@@ -1,12 +1,14 @@
 # GitLab Integration
 
-Gitpod comes with GitLab integration that allows you to start dev environments for all your GitLab projects.
+GitLab comes with a [native Gitpod integration](https://docs.gitlab.com/ce/integration/gitpod.html). This feature is enabled on GitLab.com by default, but needs to be enabled by the administrator of a GitLab self-managed instance as described in the [GitLab docs](https://docs.gitlab.com/ce/integration/gitpod.html).
 
 ## Starting Workspaces
 
-To launch new Gitpod workspaces for your projects, issues, branches, merge requests, etc. you can prefix any GitLab URL with `gitpod.io/#` (or your respective Gitpod Self-Hosted URL) as described in the [Getting Started](/docs/getting-started) page.
-Alternatively, the [browser extension](/docs/browser-extension/) can be installed to add a convenient Gitpod button to every GitLab page.
+When the Gitpod integration is enabled in GitLab, users can choose to start a Gitpod workspace as an alternative to the GitLab Web IDE directly from GitLab. Simply click on the dropdown arrow next to the `Web IDE` split button on the project or merge request page, and choose “Gitpod”. The Gitpod workspace will open in a new browser tab. Then, the next time you visit a GitLab page, the last used action will be pre-selected.
 
+![GitLab Integration](images/gitlab-integration/gitpod_button_project_page.png)
+
+To launch new Gitpod workspaces for issues, branches, specific commits, etc. you can also prefix any GitLab URL with `gitpod.io/#` as described in the [Getting Started](/docs/getting-started) page, or use the [browser extension](/docs/browser-extension/) to add a convenient Gitpod button to every GitLab page.
 
 ## Enabling Prebuilds