Forms documentation doesn't describe how to handle uploads
|Reported by:||Kyle Fox||Owned by:||Jacob|
|Severity:||Keywords:||docs, forms, files, uploads|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The general form documentation 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
" ... a form requires multipart file upload (and hence whether request.FILES must be passed to the form), etc. See Working with Forms for more information."
The documentation for handling form uploads in buried in the 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.