#14905: models.FileField links to url attribute, which is undocumented.
--------------------------------------------------+-------------------------
Reporter: Keryn Knight <ke...@kerynknight.com> | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: SVN
Keywords: filefield url | Stage: Unreviewed
Has_patch: 0 |
--------------------------------------------------+-------------------------
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.
--
Ticket URL: <http://code.djangoproject.com/ticket/14905>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to django-upda...@googlegroups.com.
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
