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
34122	models.ForeignObject is missing documentation	Ömer Faruk Abacı	nobody	"While trying to implement a custom multiple-column join I have spent hours to find an elegant way, at the end I have found an old issue here:

https://code.djangoproject.com/ticket/19385

Then I have realized that I can use `ForeignObject` for custom joins. Almost all of the solutions online suggest using raw SQLs with `Manager.raw()` or `QuerySet.extra()`, none of them mention about `ForeignObject`. I don't know if it was on purpose or not but I thought that it might be good to mention about the `ForeignObject` in the following section:

https://docs.djangoproject.com/en/4.1/ref/models/relations/

What do you think?"	Cleanup/optimization	closed	Documentation	4.1	Normal	wontfix	custom join, multiple column join, foreignobject	Simon Charette	Unreviewed	0	0	0	0	0	0