Custom User Models documentation

[arrantsquid@…]

The documentation for creating a custom user model uses the ReadOnlyPasswordHashField in the documentation. The problem with this is that it disallows users to actually change the password when they're using that field by itself. It should be changed to the following:

password = ReadOnlyPasswordHashField(label=_("Password"),
    help_text=_("Raw passwords are not stored, so there is no way to see "
                "this user's password, but you can change the password "
                "using <a href=\"password/\">this form</a>."))

​https://docs.djangoproject.com/en/dev/topics/auth/customizing/#a-full-example

[Preston Holmes]

This is not meant to be a copy-paste example, but more of an illustration of all the parts working together. The docstring of the UserChangeForm makes clear what it is composed of - your comment adds greater usability in an actual project, but does not add to the example as an illustration.

Such a disclaimer is perhaps worth adding to the introduction of the full example.

[Preston Holmes <preston@…>]

In 649118961ce3952138536235fc842921e39bfa33:

Fixed #19868 -- Clarified purpose of custom user example

[Preston Holmes <preston@…>]

In b17a572eb36acfa59cdf001c4ed3b965ade2b7a7:

[1.5.x] Fixed #19868 -- Clarified purpose of custom user example

[ArrantSquid]

Understood. Makes sense. Thanks.