[Django] #37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic page

[Django]

#37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic
page
-------------------------+------------------------------------------------
Reporter: Lincoln | Type: Cleanup/optimization
Status: new | Component: Documentation
Version: dev | Severity: Normal
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------+------------------------------------------------
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!
--
Ticket URL: <https://code.djangoproject.com/ticket/37172>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic
page

--------------------------------------+------------------------------------
Reporter: Lincoln | Owner: (none)

Type: Cleanup/optimization | Status: new
Component: Documentation | Version: dev

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0

--------------------------------------+------------------------------------
Changes (by Mike Edmunds):

* stage: Unreviewed => Accepted

Comment:

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

Specifically, the `FILE_UPLOAD_HANDLERS` setting should reference
[https://docs.djangoproject.com/en/dev/topics/http/file-uploads/#upload-
handlers 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
[https://docs.djangoproject.com/en/dev/topics/http/file-uploads/#where-
uploaded-data-is-stored Where uploaded data is stored] subsection.
--
Ticket URL: <https://code.djangoproject.com/ticket/37172#comment:1>

[Django]

#37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic
page
--------------------------------------+------------------------------------

Reporter: Lincoln | Owner: Lincoln
Type: Cleanup/optimization | Status: assigned

Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------

Changes (by Lincoln):

* owner: (none) => Lincoln
* status: new => assigned

--
Ticket URL: <https://code.djangoproject.com/ticket/37172#comment:2>

[Django]

#37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic
page
--------------------------------------+------------------------------------
Reporter: Lincoln | Owner: Lincoln
Type: Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------
Changes (by Lincoln):

* has_patch: 0 => 1

--
Ticket URL: <https://code.djangoproject.com/ticket/37172#comment:3>

[Django]

#37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic
page
--------------------------------------+------------------------------------
Reporter: Lincoln | Owner: Lincoln
Type: Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------

Comment (by Lincoln):

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.
--
Ticket URL: <https://code.djangoproject.com/ticket/37172#comment:4>

[Django]

#37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic
page
--------------------------------------+------------------------------------
Reporter: Lincoln | Owner: Lincoln
Type: Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------

Changes (by Mike Edmunds):

* needs_better_patch: 0 => 1

--
Ticket URL: <https://code.djangoproject.com/ticket/37172#comment:5>

[Django]

#37172: FILE_UPLOAD_HANDLERS settings reference should link to "File Uploads" topic
page
--------------------------------------+------------------------------------
Reporter: Lincoln | Owner: Lincoln
Type: Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------

Changes (by Lincoln):

* needs_better_patch: 1 => 0

--
Ticket URL: <https://code.djangoproject.com/ticket/37172#comment:6>