Fixed django#12008 -- Clarified relationship between template blocks and includes.

ConorMcGee · timgraham · commit 80b8d3bee035 · 2014-10-16T10:53:17.000-04:00
Thanks Daniele Procida for suggested wording.
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
@@ -700,6 +700,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
