#34154: Inconsistent use of "mixin" in the documentation
--------------------------------------------+------------------------
               Reporter:  Willem Van Onsem  |          Owner:  nobody
                   Type:  Uncategorized     |         Status:  new
              Component:  Documentation     |        Version:  4.1
               Severity:  Normal            |       Keywords:
           Triage Stage:  Unreviewed        |      Has patch:  0
    Needs documentation:  0                 |    Needs tests:  0
Patch needs improvement:  0                 |  Easy pickings:  1
                  UI/UX:  0                 |
--------------------------------------------+------------------------
 In the documentation on authentication, we see:

 > The `LoginRequired` mixin

 and further we see:

 > The `PermissionRequiredMixin` mixin

 In the first, it does not include the `Mixin` suffix, whereas in the
 latter, it does. I think it is better to use the latter, since that refers
 to the real name of the mixin, and furthermore the
 [https://en.wikipedia.org/wiki/RAS_syndrome RAS syndrome] is usually
 allowed repeating `Mixin` twice.

 Another option could be to format it with:

 > The `LoginRequiredMixin`.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/34154>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/010701846d5381d8-2fabc517-2d8c-4ead-a63c-713a1ce8287f-000000%40eu-central-1.amazonses.com.

Reply via email to