#35939: Reference documentation for auth.Permission should link to ContentType
-------------------------------------+-------------------------------------
     Reporter:  Baptiste Mispelon    |                     Type:
                                     |  Cleanup/optimization
       Status:  new                  |                Component:
                                     |  Documentation
      Version:  5.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
-------------------------------------+-------------------------------------
 The reference documentation for `Permission.content_type` [1] [2]
 describes the field as:

 > A reference to the django_content_type database table, which contains a
 record for each installed model.

 This seems to me like a more complicated way of saying "A foreign key to
 the ContentType model". On top of that, it would be useful if either the
 old wording ("django_content_type table") or the new one ("ContentType
 model") could link to the reference documentation of the model [3]

 [1]
 
https://docs.djangoproject.com/en/dev/ref/contrib/auth/#django.contrib.auth.models.Permission.content_type
 [2]
 https://github.com/django/django/blob/main/docs/ref/contrib/auth.txt#L422
 [3] https://docs.djangoproject.com/en/dev/ref/contrib/contenttypes/#the-
 contenttype-model
-- 
Ticket URL: <https://code.djangoproject.com/ticket/35939>
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 visit 
https://groups.google.com/d/msgid/django-updates/01070193648fdf8f-9cb4841f-88b2-4ee3-99ac-2ecf2e84cfd1-000000%40eu-central-1.amazonses.com.

Reply via email to