summaryrefslogtreecommitdiff
path: root/docs/narr/project.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/narr/project.rst')
-rw-r--r--docs/narr/project.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index fc1d473ac..b4397c09b 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -908,6 +908,17 @@ returns the HTML in a :term:`response`.
See :ref:`views_which_use_a_renderer` for more information about how views,
renderers, and templates relate and cooperate.
+.. note:: ``development.ini`` has a setting that controls how templates are
+ reloaded: ``pyramid.reload_templates``.
+
+ - A setting of ``True`` (as in the scaffold ``development.ini``)
+ automatically reloads changed templates without a server restart. This
+ is convenient while developing but slows template rendering speed.
+
+ - A setting of ``False`` (the default) requires a server restart to
+ integrate template changes. Production applications should set
+ ``pyramid.reload_templates = False``.
+
.. index::
single: static directory