﻿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
36095	Explicitly introduce lazy references in early sections of the docs before they are used.	Clifford Gama	Clifford Gama	"While reading https://docs.djangoproject.com/en/dev/topics/db/models/, I noticed two issues:
1. Lazy relationships are used in the documentation before they are explicitly introduced https://docs.djangoproject.com/en/dev/topics/db/models/#extra-fields-on-many-to-many-relationships
2. The `ManyToManyField.through` option does not document that it supports lazy references.

To address these:

For the first issue, I propose explicitly introducing lazy references in the introductory [https://docs.djangoproject.com/en/dev/topics/db/models/#models-across-files Models across files] section.
For the second issue, I propose adding a note to the `ManyToManyField.through` section, clarifying that it supports both lazy references and direct model classes."	Cleanup/optimization	closed	Documentation	5.1	Normal	fixed			Ready for checkin	1	0	0	0	0	0
