diff --git a/README.md b/README.md
index b92c6dc5b7cd64dfd021386c82a8e8cdf2559644..b39df19f45da5383b65d1e7da9c3d3a02eb48fe4 100644
--- a/README.md
+++ b/README.md
@@ -56,7 +56,7 @@ Please see the [requirements documentation](doc/install/requirements.md) for sys
 ## Installation
 
 The recommended way to install GitLab is with the [Omnibus packages](https://about.gitlab.com/downloads/) on our package server.
-Compared to an installation from source, this is faster and less error prone.
+Compared to [a self-compiled installation](https://docs.gitlab.com/install/installation/), this is faster and less error prone.
 Just select your operating system, download the respective package (Debian or RPM) and install it using the system's package manager.
 
 There are various other options to install GitLab, please refer to the [installation page on the GitLab website](https://about.gitlab.com/installation/) for more information.
@@ -67,8 +67,8 @@ GitLab is an open source project and we are very happy to accept community contr
 
 ## Install a development environment
 
-To work on GitLab itself, we recommend setting up your development environment with [the GitLab Development Kit](https://gitlab.com/gitlab-org/gitlab-development-kit).
-If you do not use the GitLab Development Kit you need to install and configure all the dependencies yourself, this is a lot of work and error prone.
+To work on GitLab itself, we recommend setting up your development environment with [the GitLab Development Kit (GDK)](https://gitlab.com/gitlab-org/gitlab-development-kit).
+If you do not use GDK, you need to [install and configure all the dependencies yourself](https://docs.gitlab.com/install/installation/), this is a lot of work and error prone.
 One small thing you also have to do when installing it yourself is to copy the example development Puma configuration file:
 
 ```shell