#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 django-updates+unsubscr...@googlegroups.com.
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