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
20735	Confusing ManyToManyField constructor documentation	chrismedrela	nobody	"The documentation says (https://docs.djangoproject.com/en/dev/ref/models/fields/#django.db.models.ManyToManyField):

    **//class// ManyToManyField(//othermodel[, * *options]//)**

    A many-to-many relationship. Requires a positional argument: the class to which the model is related. This works exactly the same as it does for ForeignKey, including all the options regarding recursive and lazy relationships.

It's confusing, because `to_field` option is valid for `ForeignKey`, but it's not supported by `ManyToManyFields`."	Cleanup/optimization	closed	Documentation	1.5	Normal	fixed			Accepted	1	0	0	0	0	0