#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.