Code

Opened 6 years ago

Closed 6 years ago

#7653 closed (wontfix)

The documentation should be more explicit about file upload sizes

Reported by: julien Owned by: nobody
Component: Documentation Version: master
Severity: Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

I presume all Django users don't necessarily know that 2.5 MB is equal to 2621440 bytes. There should be a newbie-friendly explanation on how to to set the FILE_UPLOAD_MAX_MEMORY_SIZE setting.

Attachments (1)

upload_doc.diff (908 bytes) - added by julien 6 years ago.

Download all attachments as: .zip

Change History (4)

Changed 6 years ago by julien

comment:1 Changed 6 years ago by Josh_Rosen

  • Has patch set
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset

comment:2 Changed 6 years ago by serialx

  • Triage Stage changed from Unreviewed to Ready for checkin

comment:3 Changed 6 years ago by mtredinnick

  • Resolution set to wontfix
  • Status changed from new to closed

It doesn't matter if the reader knows how big 2.5MB is in the end. They either leave the setting alone or set it to a number that is appropriate for that system (and if they're doing the latter, they must know how to measure). Django's documentation assumes you know how to program in Python and edit text files. Assuming you know how to use Google in the unlikely event you don't know what a megabyte is would also be a reasonable assumption.

This patch isn't bad, except it adds a whole paragraph that makes something look important when it's really very, very trivial. So it detracts from the surrounding, more important, information.

Add Comment

Modify Ticket

Change Properties
<Author field>
Action
as closed
as The resolution will be set. Next status will be 'closed'
The resolution will be deleted. Next status will be 'new'
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.