diff --git a/lib/config_def.yaml b/lib/config_def.yaml
index c1bbf7cd9..3204dff78 100644
--- a/lib/config_def.yaml
+++ b/lib/config_def.yaml
@@ -2,6 +2,8 @@
 storage: ./storage
 
 # a list of users
+#
+# This could be deprecated soon, use "users_file" instead.
 users:
   admin:
     # crypto.createHash('sha1').update(pass).digest('hex')
@@ -9,7 +11,8 @@ users:
 
 users_file: ./htpasswd
 
-# set this to 0 to disable registration
+# Maximum amount of users allowed to register, defaults to "+inf".
+# You can set this to 0 to disable registration.
 #max_users: 1000
 
 # a list of other known repositories we can talk to