document behavior of block tag in if block

closes #423

diff --git a/docs/templates.rst b/docs/templates.rst
index f1f3c2f052e9b27585099317e2303fa01ed4217f..46a237f45fa266e95cc94fe87c9c527de0f79498 100644 (file)
--- a/docs/templates.rst
+++ b/docs/templates.rst
@@ -370,6 +370,10 @@ In this example, the ``{% block %}`` tags define four blocks that child template
 can fill in. All the `block` tag does is tell the template engine that a
 child template may override those placeholders in the template.
 
+``block`` tags can be inside other blocks such as ``if``, but they will
+always be executed regardless of if the ``if`` block is actually
+rendered.
+
 Child Template
 ~~~~~~~~~~~~~~