Opened 5 years ago

Closed 4 years ago

#17935 closed Cleanup/optimization (fixed)

Media and Static files docs

Reported by: Thomas Güttler Owned by: Adrien Lemaire
Component: Documentation Version: 1.4
Severity: Normal Keywords:
Cc: hv@…, lemaire.adrien@… Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: yes
Easy pickings: yes UI/UX: no

Description

Old:

This document describes Django’s file access APIs.

New:

This document describes Django’s file access APIs for FileField and ImageField. If you want to handle static files (JS, CSS, ...) see Managing static files.

Attachments (2)

doc-media-files.patch (666 bytes) - added by Thomas Güttler 5 years ago.
0001-cleaning-media-and-static-files-docs-urls.patch (67.1 KB) - added by Adrien Lemaire 5 years ago.

Download all attachments as: .zip

Change History (9)

Changed 5 years ago by Thomas Güttler

Attachment: doc-media-files.patch added

comment:1 Changed 5 years ago by Claude Paroz

Patch needs improvement: set
Triage Stage: UnreviewedAccepted

The link to static files is welcome. However, the page is more than mere FileField and ImageField. Could you try to find a formulation that better represents the page content?

comment:2 Changed 5 years ago by Adrien Lemaire

Owner: changed from nobody to Adrien Lemaire

I'm going to offer a bigger patch.
For me, this is just "Managing Media files", and therefore it doesn't make sense to have a /topics/files for media files and /howto/static-files/ for static files.

comment:3 Changed 5 years ago by Adrien Lemaire

Version: 1.31.4

comment:4 Changed 5 years ago by Adrien Lemaire

Cc: lemaire.adrien@… added

Changed 5 years ago by Adrien Lemaire

comment:5 Changed 5 years ago by Adrien Lemaire

Summary: Media Files docs: Link to static files docMedia and Static files docs
Triage Stage: AcceptedDesign decision needed

Changing the stage to DDN as I realized I went over the initial purpose of this ticket.

Here what I did:

  • Clearly name "Managing media files" or "Managing static files" when calling those docs
  • Move /topics/files into /topics/files/media
  • Move /howto/static-files into /topics/files/static

comment:6 Changed 4 years ago by Tim Graham

Triage Stage: Design decision neededAccepted

I don't think we'll move the files around (the patch won't apply cleanly after #19897), but moving back to accepted to finish the initial scope of the ticket.

comment:7 Changed 4 years ago by Tim Graham <timograham@…>

Resolution: fixed
Status: newclosed

In f7795e968dd07323aa5bd16f9da0e60d97a75d0f:

Fixed #17935 - Clarified intro of topics/files.txt.

Thanks guettli for the suggestion.

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