﻿id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
35072	Model docs Field.choices inconsistency between reference and topic guide	Zowie Beha	Zowie Beha	"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).
"	Cleanup/optimization	closed	Documentation	5.0	Normal	fixed	documentation, model, field	Zowie Beha	Ready for checkin	1	0	0	0	1	0
