#9535: File uploads documentation is patchy
------------------------------------------------------------+---------------
          Reporter:  Daniel Pope <[email protected]>  |         Owner:  
jacob
            Status:  assigned                               |     Milestone:    
   
         Component:  Documentation                          |       Version:  
1.0  
        Resolution:                                         |      Keywords:    
   
             Stage:  Accepted                               |     Has_patch:  0 
   
        Needs_docs:  0                                      |   Needs_tests:  0 
   
Needs_better_patch:  0                                      |  
------------------------------------------------------------+---------------
Comment (by onelson):

 This just came up on the mailing list, and as I started to look at the
 problem I found the docs in pretty much the same state today (a year on
 from the last update).
 The required reading to work with file uploads (and File/Image model
 fields) is spread around on the following pages:

  * http://docs.djangoproject.com/en/dev/ref/files/file/
  * http://docs.djangoproject.com/en/dev/topics/http/file-uploads/
  * http://docs.djangoproject.com/en/dev/topics/files/
  *
 
http://docs.djangoproject.com/en/dev/ref/models/fields/#django.db.models.FileField

 If people are happy with the idea of taking the http/file-uploads topic
 and expanding there, we can probably reduce the mystery a bit by adding
 some additional examples. Personally, when it comes to working with
 `models.FileField.save()` directly, my initial stumbling block was I
 didn't get that '''`contents`''' argument needed to be an instance of
 `django.core.files.File` rather than a regular file object.  This is
 mentioned quietly.

-- 
Ticket URL: <http://code.djangoproject.com/ticket/9535#comment:5>
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 [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/django-updates?hl=en.

Reply via email to