Browse files

Fixed #20284 - Added a note about DEBUG in static file docs.

Thanks wim@ for the suggestion and Nicolas Noé for the patch.
  • Loading branch information...
1 parent 2335fdd commit 2c84f4434cd0f6e74471d5737b049c648cff538f @timgraham timgraham committed May 18, 2013
Showing with 14 additions and 2 deletions.
  1. +14 −2 docs/howto/static-files/index.txt
@@ -35,8 +35,20 @@ Configuring static files
4. Store your static files in a folder called ``static`` in your app. For
example ``my_app/static/my_app/myimage.jpg``.
-Now, if you use ``./ runserver``, all static files should be served
-automatically at the :setting:`STATIC_URL` and be shown correctly.
+.. admonition:: Serving the files
+ In addition to these configuration steps, you'll also need to actually
+ serve the static files.
+ During development, this will be done automatically if you use
+ :djadmin:`runserver` and :setting:`DEBUG` is set to ``True`` (see
+ :func:`django.contrib.staticfiles.views.serve`).
+ This method is **grossly inefficient** and probably **insecure**,
+ so it is **unsuitable for production**.
+ See :doc:`/howto/static-files/deployment` for proper strategies to serve
+ static files in production environments.
Your project will probably also have static assets that aren't tied to a
particular app. In addition to using a ``static/`` directory inside your apps,

0 comments on commit 2c84f44

Please sign in to comment.