Add docstring to explain param

rattail_fabric2/core.py

@@ -129,11 +129,15 @@ def mkdir(c, paths, owner=None, mode=None,
 
 
 def make_normal_user(c, username, full_name=None,
-                     # TODO: ugh why is this true by default..should change that
                      disabled_login=True,
                      password=None):
     """
     Make a new "normal" user account.
+
+    :param disabled_login: If true (the default), add the
+       ``--disabled-login`` flag to the ``adduser`` command.  The
+       reason this is the default, is to avoid being prompted for a
+       password to give the new account.
     """
     if not c.run('getent passwd {}'.format(username), warn=True).failed:
         return