Ticket #5125: templates.diff

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
+    
+    The template language is intended to provide the minimal necessary set of 
+    features to allow you to express presentation; it is not a programming language, 
+    and is not the same as the Python programming language. This is done deliberately,
+    to stop program logic from creeping into templates and to enable non-programmers 
+    such as designers to work with these.
+
+    If you're looking for a construct from Python -- operators, functions, method calls,
+    etc. -- it probably will not be available in the template language, or will be 
+    implemented in a different form. For example, instead of Python's if construct there
+    is an {% if %} template tag, and the template tag operates in a very different manner
+    from the if construct in Python. If you don't see the feature you want listed on this
+    page, it is not available by default in the template system (though you are free to
+    define a custom template tag to implement it).
+
 .. _Smarty: http://smarty.php.net/
 .. _CheetahTemplate: http://www.cheetahtemplate.org/