diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index 2f38a1512b..0cae2766ea 100644 --- 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 %}`. .. templatetag:: load