Opened 4 days ago

Last modified 3 days ago

#37172 assigned Cleanup/optimization

FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic page

Reported by: Lincoln Owned by: Lincoln
Component: Documentation Version: dev
Severity: Normal Keywords:
Cc: Lincoln Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

The FILE_UPLOAD_HANDLERS settings reference:

https://docs.djangoproject.com/en/dev/ref/settings/#file-upload-handlers

Currently links to the "Managing files" topic page (https://docs.djangoproject.com/en/dev/topics/files/) - "See Managing files for details."
Nothing on this topic page actually talks about file uploads, it is mostly about files in models and file storage.

I think the settings reference should instead link to the "File uploads" topic page (https://docs.djangoproject.com/en/dev/topics/http/file-uploads/),
because that page has the "Upload Handlers" section that actually talks about that setting and how it is used.

Probably could make the same change to settings reference for FILE_UPLOAD_MAX_MEMORY_SIZE and FILE_UPLOAD_TEMP_DIR

I am happy to provide a PR if this ticket is accepted.

Thanks!

Change History (4)

comment:1 by Mike Edmunds, 3 days ago

Triage Stage: UnreviewedAccepted

Thanks for the report. That does seem like a much better link.

Specifically, the FILE_UPLOAD_HANDLERS setting should reference Upload handlers in the File uploads topic.

I agree the links in FILE_UPLOAD_MAX_MEMORY_SIZE and FILE_UPLOAD_TEMP_DIR should also be changed. Those could either go to the the same Upload handlers section or its Where uploaded data is stored subsection.

comment:2 by Lincoln, 3 days ago

Owner: set to Lincoln
Status: newassigned

comment:3 by Lincoln, 3 days ago

Has patch: set

comment:4 by Lincoln, 3 days ago

Thanks! PR is open. I made all the links go to the Upload handlers section since a) I didn't want to link too deep into the document tree and b) The "Where uploaded data is stored" section is still visible on screen when opening to its parent header.

Note: See TracTickets for help on using tickets.
Back to Top