Ticket #5125: 5125.diff

docs/templates.txt

@@ -7 +7 @@
 you have any exposure to other text-based template languages, such as Smarty_
 or CheetahTemplate_, you should feel right at home with Django's templates.
 
+.. admonition:: Philosophy
+
+    If you have a background in programming, or if you're used to
+    languages like PHP which mix programming code directly into
+    HTML, you'll want to bear in mind that the Django template system
+    is not simply Python embedded into HTML. This is by design: the
+    template system is meant to express presentation, not program
+    logic.
+    
+    The Django template system does provide tags which function
+    similarly to some programming constructs -- an ``{% if %}`` tag
+    for boolean tests, a ``{% for %}`` tag for looping, etc. -- but
+    these are not simply executed as the corresponding Python code,
+    and the template system will not execute arbitrary Python
+    expressions; only the tags, filters and syntax listed below are
+    supported by default (though you can add `your own extensions`_ to
+    the template language as needed).
+
 .. _Smarty: http://smarty.php.net/
 .. _CheetahTemplate: http://www.cheetahtemplate.org/
+.. _your own extensions: ../templates_python/#extending-the-template-system
 
 Templates
 =========