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
32280	Change all documentation examples using variable-length tuples into lists	Adam Johnson	nobody	"In many places in the documentation we have examples using varible-length tuples, for example `ModelAdmin.fields` which takes any number of fields.

For all the reasons I wrote up in my post [https://adamj.eu/tech/2019/07/05/tuples-versus-lists-in-python/ tuples versus lists] I think it would be good to convert all such examples to lists. This would make the documentation more beginner-friendly and less prone to propagating these mistakes.

There's also a general guideline I saw (from Guido maybe?) that tuples are intended for fixed-length records where the position is part of the meaning - e.g. `(x, y)` coordinates - and lists are for variable-length collections of homogenous-meaning items. So all our variable-length tuples would be better as lists under this guideline."	Cleanup/optimization	closed	Documentation	dev	Normal	duplicate			Unreviewed	0	0	0	0	0	0