Code

Opened 3 years ago

Closed 3 years ago

Last modified 3 years ago

#14538 closed (fixed)

STATICFILES_DIRS must be set for dev, docs could be improved

Reported by: romaniuk Owned by: jezdez
Component: Contrib apps Version: master
Severity: Keywords: staticfiles, static
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

The documentation for the STATICFILES_DIRS setting at:
http://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#std:setting-STATICFILES_DIRS
mentioned that it's required "if you use ... the static file serving view".

But it would be really great if this was mentioned also in the documentation for serving static files in development here:
http://docs.djangoproject.com/en/dev/howto/static-files/#serving-static-files-in-development

By the way, if you don't set STATICFILES_DIRS, instead of getting your static file you'll be served a very simple page that says "Page not found: path/to/staticfile". I spend hours debugging this, not realizing the setting was required. If you'd like me to submit a patch to the documentation, could you give me starting point for how to do this, as I am very new here.

Attachments (0)

Change History (3)

comment:1 Changed 3 years ago by jezdez

  • milestone set to 1.3
  • Needs documentation unset
  • Needs tests unset
  • Owner changed from nobody to jezdez
  • Patch needs improvement unset
  • Status changed from new to assigned
  • Triage Stage changed from Unreviewed to Accepted

comment:2 Changed 3 years ago by jezdez

  • Resolution set to fixed
  • Status changed from assigned to closed

(In [14323]) Fixed #14528 and #14538 -- Refined staticfiles documentation. Thanks, gremmie and romaniuk.

comment:3 Changed 3 years ago by jacob

  • milestone 1.3 deleted

Milestone 1.3 deleted

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.