summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2011-09-05 16:03:01 -0400
committerChris McDonough <chrism@plope.com>2011-09-05 16:03:01 -0400
commit2b65bbb451d5b7cd87ff198cf88374dab28fd17b (patch)
treec8a9f0a3177fa39cca03dd5cd5c4fd0cc5793004 /docs
parent20646a7bca104d5a837fcf336a5d1403b3656aa3 (diff)
downloadpyramid-2b65bbb451d5b7cd87ff198cf88374dab28fd17b.tar.gz
pyramid-2b65bbb451d5b7cd87ff198cf88374dab28fd17b.tar.bz2
pyramid-2b65bbb451d5b7cd87ff198cf88374dab28fd17b.zip
add explanation of why to use production.ini
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/project.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index 102078353..10b7a5d04 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -566,6 +566,13 @@ are not automatically reloaded when changed, and turns off all debugging
options. This file is appropriate to use instead of ``development.ini`` when
you put your application into production.
+It's important to use ``production.ini`` (and *not* ``development.ini``) to
+benchmark your application and put it into production. ``development.ini``
+configures your system with a debug toolbar that helps development, but the
+inclusion of this toolbar slows down page rendering times by over an order of
+magnitude. The debug toolbar is also a potential security risk if you have
+it configured incorrectly.
+
.. index::
single: MANIFEST.in