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
22341	Split django.db.models.fields.related into multiple modules.	loic84	Aymeric Augustin	"The `django.db.models.fields.related` module is very large and pretty hard to work with.

It contains a lot of similar concepts with only slight differences, and one thing can easily be mistaken for its exact opposite, which makes navigating the file very error-prone. This is made worse by the fact that some class name are borderline wrong, (e.g. `ReverseSingleRelatedObjectDescriptor` which actually is the forward FK descriptor).

Quoting akaariai: ""fields/related.py is a brain melting machine"".

This ticket proposes that we turn `related.py` into a package with the following modules: `related_field.py`, `many_to_one.py`, `one_to_one.py` and `many_to_many.py`.
"	Cleanup/optimization	closed	Database layer (models, ORM)	dev	Normal	fixed			Ready for checkin	1	0	0	0	0	0