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	nobody	"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.""

I think this inconsistency is present because support for mappings as choices was introduced in Django 5.0, and the topic page hasn't yet been updated to reflect that change. It should also be mentioned in the topic guide that a callable is a valid choices value.
"	Cleanup/optimization	new	Documentation	5.0	Normal		documentation, model, field		Unreviewed	0	0	0	0	1	0