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
23974	Ambiguous description of save option of FileField.save() method	GreenAsJade	nobody	"Here:

https://docs.djangoproject.com/en/dev/ref/models/fields/#django.db.models.FileField

The FileField.save() method's save argument is described thusly:


""The optional save argument controls whether or not the instance is saved after the file has been altered. Defaults to True.""

It's not clear what instance is being referred to here: is it the instance of FileField (which gramatically appears to be the case) or the instance of the model that has the FileField (which I think is the case, and makes more sense).

Note that in other places on this page, the field itself is referred to as an instance.

It would be better if this said

""The optional save argument controls whether or not the model instance is saved after the file associated with this FileField has been altered. Defaults to True."""	Cleanup/optimization	closed	Documentation	1.7	Normal	fixed			Unreviewed	0	0	0	0	1	0