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 8857,Forms documentation doesn't describe how to handle uploads,Kyle Fox,Jacob,"The general form documentation [http://docs.djangoproject.com/en/dev/topics/forms/ Working with Forms] does not mention how to handle forms that include files. There is no mention of passing `request.FILES` into the Form's constructor, nor of the required `enctype=""multipart/form-data""` attribute of the `
` tag. However, the ""next"" article [http://docs.djangoproject.com/en/dev/topics/forms/modelforms/#the-save-method Creating forms from models] refers back to [http://docs.djangoproject.com/en/dev/topics/forms/ Working with Forms] for handling file uploads.: "" ... a form requires multipart file upload (and hence whether request.FILES must be passed to the form), etc. See [http://docs.djangoproject.com/en/dev/topics/forms/ Working with Forms] for more information."" The documentation for handling form uploads in buried in the [http://docs.djangoproject.com/en/dev/ref/forms/api/#binding-uploaded-files Forms API]. It would be very useful to have this info (or a link to it) in the introductory ""Working with forms"" document. At the very least, the reference to ""Working with forms"" from ""Creating forms from models"" needs to be removed, since the information is not contained there.",,closed,Documentation,dev,,fixed,"docs, forms, files, uploads",,Accepted,0,0,0,0,0,0