  
  .. class:: models.UserManager
  
      The :class:`~django.contrib.auth.models.User` model has a custom manager
      that has the following helper methods:
  
      .. method:: create_user(username, email=None, password=None)
  
          Creates, saves and returns a :class:`~django.contrib.auth.models.User`.
  
 
</s> remove     .. method:: create_user(username, email=None, password=None)
 </s> add     .. method:: create_user(username, email=None, password=None, **extra_fields) </s> remove         Returns a random password with the given length and given string of
        allowed characters. (Note that the default value of ``allowed_chars``
        doesn't contain letters that can cause user confusion, including:
 </s> add     .. method:: create_superuser(self, username, email, password, **extra_fields) </s> remove     .. method:: make_random_password(length=10, allowed_chars='abcdefghjkmnpqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789')
 </s> add         See :ref:`Creating users <topics-auth-creating-users>` for example usage. </s> remove         See :ref:`Creating users <topics-auth-creating-users>` for example usage.
 </s> add         The ``extra_fields`` keyword arguments are passed through to the
        :class:`~django.contrib.auth.models.User`'s ``__init__`` method to
        allow setting arbitrary fields on a :ref:`custom User model
        <auth-custom-user>`. </s> remove         * ``i``, ``l``, ``I``, and ``1`` (lowercase letter i, lowercase
          letter L, uppercase letter i, and the number one)
        * ``o``, ``O``, and ``0`` (uppercase letter o, lowercase letter o,
          and zero)
 </s> add         Same as :meth:`create_user`, but sets :attr:`~models.User.is_staff` and
        :attr:`~models.User.is_superuser` to ``True``.
    that has the following helper methods (in addition to the methods provided
    by :class:`~django.contrib.auth.models.BaseUserManager`):
  
  .. class:: models.UserManager
  
      The :class:`~django.contrib.auth.models.User` model has a custom manager
    that has the following helper methods (in addition to the methods provided
    by :class:`~django.contrib.auth.models.BaseUserManager`):
  
      .. method:: create_user(username, email=None, password=None)
  
          Creates, saves and returns a :class:`~django.contrib.auth.models.User`.
  
keep keep keep keep replace keep keep keep keep keep
 Fixed #19588 - Added create_superuser to UserManager docs.

Thanks minddust for the report. 
docs/ref/contrib/auth.txt