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
32372	"Improve consistency in ""Related objects reference"" docs."	Jack Aitken	Jack Aitken	"I have a suggested clarification in the docs, under the ""Related objects reference"" section: [https://docs.djangoproject.com/en/3.1/ref/models/relations/].

One of the first examples of a ManyToMany field relationship begins with an example of a Pizza model and a Toppings model, but in the shell example below it demonstrates this relationship with two different models: a Blog model and an Entry model. 

I've read through this section a few times so I apologize in advance if I'm incorrect in my understanding, but in my opinion it would be clearer to stick with one set of classes for both the examples. If choosing to continue with the Pizza and Toppings example, I would suggest changing the example shown in the shell as follows:

{{{
>>> t = Topping.objects.get(id=1)
>>> p = Pizza.objects.get(id=5)
>>> t.pizza_set.add(p) # Associates Topping t with Pizza p.
}}}


If this is agreeable, I would love to make this change. "	Cleanup/optimization	closed	Documentation	3.1	Normal	fixed			Accepted	1	0	0	0	1	0