[1.11.x] Fixed #27730 -- Doc'd that template vars created outside a block can't be used in it.

Backport of 278a09ac1f410cf4e3472146324feded2e2c18b3 from master

1 files changed, 7 insertions, 0 deletions

diff --git a/docs/ref/templates/language.txt b/docs/ref/templates/language.txt
index d6f13a637f..69ad5491d8 100644
--- a/docs/ref/templates/language.txt
+++ b/docs/ref/templates/language.txt
@@ -407,6 +407,13 @@ Here are some tips for working with inheritance:
   not be automatically escaped (see the `next section`_), since it was
   already escaped, if necessary, in the parent template.
 
+* Variables created outside of a :ttag:`{% block %}<block>` using the template
+  tag ``as`` syntax can't be used inside the block. For example, this template
+  doesn't render anything::
+
+      {% trans "Title" as title %}
+      {% block content %}{{ title }}{% endblock %}
+
 * For extra readability, you can optionally give a *name* to your
   ``{% endblock %}`` tag. For example::