diff --git a/docs/auth.md b/docs/auth.md
index 8d4602f..f253ff1 100644
--- a/docs/auth.md
+++ b/docs/auth.md
@@ -83,4 +83,17 @@ If you've signed up with the account name `tuser`, you can generate your new cer
     Important note WRT OTP: If you have enabled Two Factor auth, you absolutely need to get a valid kerberos ticket through other step *before* using centos-cert. See details on the [Fedora Accounts Documentation](https://docs.fedoraproject.org/en-US/fedora-accounts/user/#twofactor) for this
 
 
- 
+## Linking your CentOS account to gitlab
+
+The first thing to understand is that gitlab will "link" an existing account
+with third party authentication system. In other words, you need to have a
+gitlab account and be logged in onto gitlab.com before you can associate your
+account with the CentOS Account System (ACO).
+
+So if you do not have a gitlab account, create one and log with it into [
+https://gitlab.com](https://gitlab.com). Then visit the following link [
+https://id.centos.org/gitlab](https://id.centos.org/gitlab) to associate your
+account with CentOS' Account System.
+
+From there on, everytime you visit this link, your group membership defined in
+ACO, will be refreshed on gitlab.
diff --git a/docs/gitlab.md b/docs/gitlab.md
index 455546e..70e53d8 100644
--- a/docs/gitlab.md
+++ b/docs/gitlab.md
@@ -5,17 +5,8 @@ should follow.
 
 ## Login in
 
-The first thing to understand is that gitlab will "link" an existing account
-with third party authentication system. In other words, you need to have a
-gitlab account and be logged in onto gitlab.com before you can associate your
-account with the CentOS Account System (ACO).
-
-So if you do not have a gitlab account, create one. Then visit the following
-link [https://id.centos.org/gitlab](https://id.centos.org/gitlab) to associate
-your account with CentOS' Account System.
-
-From there on, everytime you visit this link, your group membership defined in
-ACO, will be refreshed on gitlab.
+Instructions on how to link your CentOS account with a gitlab account can be
+found in our [Authentication page](auth.md#linking-your-centos-account-to-gitlab).
 
 ## Content