[1.7.x] Fixed #12008 -- Clarified relationship between template blocks and includes.

ConorMcGee · timgraham · commit b729ef0bda50 · 2014-10-16T10:54:35.000-04:00
Thanks Daniele Procida for suggested wording. Backport of 80b8d3b from master
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
@@ -738,6 +738,11 @@ available to the included template::
     This means that there is no shared state between included templates --
     each include is a completely independent rendering process.
 
+    Blocks are evaluated *before* they are included. This means that a template
+    that includes blocks from another will contain blocks that have *already
+    been evaluated and rendered* - not blocks that can be overridden by, for
+    example, an extending template.
+
 See also: :ttag:`{% ssi %}<ssi>`.
 
 .. templatetag:: load
