diff --git a/config/gitlab.yml.example b/config/gitlab.yml.example
index f628ac9121f9bb778ebe067cf7e4b3dba420705f..cdab54faaf85b715f5e941e8336b68cc81e0f27c 100644
--- a/config/gitlab.yml.example
+++ b/config/gitlab.yml.example
@@ -129,9 +129,12 @@ production: &base
     password: '_the_password_of_the_bind_user'
     # If allow_username_or_email_login is enabled, GitLab will ignore everything
     # after the first '@' in the LDAP username submitted by the user on login.
+    #
     # Example:
     # - the user enters 'jane.doe@example.com' and 'p@ssw0rd' as LDAP credentials;
     # - GitLab queries the LDAP server with 'jane.doe' and 'p@ssw0rd'.
+    #
+    # Disable this setting if you are using "uid: 'userPrincipalName'" on ActiveDirectory.
     allow_username_or_email_login: true
 
   ## OmniAuth settings