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
14905	models.FileField links to url attribute, which is undocumented.	Keryn Knight <keryn@…>	nobody	"As part of the documentation callout on {{{ FileField.storage }}} found in the Model Field Types documentation [http://docs.djangoproject.com/en/dev/ref/models/fields/#django.db.models.FileField.storage here], reference is made to the {{{ FileField.url }}} attribute, which links to the documentation [http://docs.djangoproject.com/en/dev/ref/files/file/#django.core.files.File.url on the File class itself], where it is decidedly absent.

Following the rabbit hole from the original note on the modelfields through the [http://docs.djangoproject.com/en/dev/topics/files/ Managing Files] documentation, and on to the how-to on [http://docs.djangoproject.com/en/dev/howto/custom-file-storage/#writing-a-custom-storage-system writing a custom storage backend] (where a note is made that any custom solution must implement the {{{ url() }}} method) we finally end up at the [http://docs.djangoproject.com/en/dev/ref/files/storage/ Storage API] which does discuss the method.

It's a convoluted process, and I think the ref documentation on File should either document the attribute, or the model FileField reference should link to the documentation for the Storage API itself. 

I can attempt to work up a documentation patch if the ticket has merit."		closed	Documentation	dev		fixed	filefield url easy-pickings		Accepted	1	0	0	0	0	0