#35072 closed Cleanup/optimization (fixed)
Model docs Field.choices inconsistency between reference and topic guide
| Reported by: | Zowie Beha | Owned by: | Zowie Beha |
|---|---|---|---|
| Component: | Documentation | Version: | 5.0 |
| Severity: | Normal | Keywords: | documentation, model, field |
| Cc: | Zowie Beha | Triage Stage: | Ready for checkin |
| Has patch: | yes | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | yes | UI/UX: | no |
Description (last modified by )
https://docs.djangoproject.com/en/5.0/ref/models/fields/#django.db.models.Field.choices
On this reference page, Field.choices is described as:
"A mapping or iterable in the format described below to use as choices for this field."
https://docs.djangoproject.com/en/5.0/topics/db/models/#field-options
Here on the topic guide however, the description is:
"A sequence of 2-tuples to use as choices for this field."
A mapping is used as an example in the topic guide, however it might be better to mention explicitly/upfront all valid choices values (such as callables for example).
Change History (12)
comment:1 by , 23 months ago
| Description: | modified (diff) |
|---|
comment:2 by , 23 months ago
| Description: | modified (diff) |
|---|
comment:3 by , 23 months ago
| Description: | modified (diff) |
|---|
comment:4 by , 23 months ago
| Cc: | added |
|---|
comment:5 by , 23 months ago
| Owner: | changed from to |
|---|---|
| Status: | new → assigned |
comment:6 by , 23 months ago
| Description: | modified (diff) |
|---|
comment:7 by , 23 months ago
comment:8 by , 23 months ago
| Has patch: | set |
|---|
comment:9 by , 23 months ago
| Patch needs improvement: | set |
|---|---|
| Triage Stage: | Unreviewed → Accepted |
comment:10 by , 23 months ago
| Patch needs improvement: | unset |
|---|---|
| Triage Stage: | Accepted → Ready for checkin |
Note:
See TracTickets
for help on using tickets.
PR: https://github.com/django/django/pull/17663