Opened 2 hours ago
Last modified 68 minutes ago
#35939 new Cleanup/optimization
Reference documentation for auth.Permission should link to ContentType
| Reported by: | Baptiste Mispelon | Owned by: | |
|---|---|---|---|
| Component: | Documentation | Version: | 5.1 |
| Severity: | Normal | Keywords: | |
| Cc: | Triage Stage: | Accepted | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | yes | UI/UX: | no |
Description
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