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
21986	The documentation provides no indication as to why you might want to use indexes	django-issues@…	bbaja42	"Indexing is not an inherently straightforward and intuitive concept. There's plenty of material out there that suggests where you might want to apply database indexes, but the Django documentation doesn't suggest *anything*. [https://docs.djangoproject.com/en/dev/topics/db/optimization/ Database access optimization] suggests that it is a number one priority, and that you should use the information you have gleaned from profiling to decide what to index, but provides no methodology for applying that information. It's left to the reader's imagination to decide if they should add indexes to fields they read a lot or fields they change a lot or fields they do lookups by a lot or fields that have fish puns in their names.

I'd make some suggestions, but I am not qualified enough to write anything I'd be at all confident in."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed		django-issues@…	Accepted	1	0	0	1	1	0