Fixed #18125 -- Explained caveat with filters

Thanks ebrelsford AT gmail.com and oinopion.

1 files changed, 4 insertions, 0 deletions

diff --git a/docs/topics/templates.txt b/docs/topics/templates.txt
index e88a7b70f0..2fa6643975 100644
--- a/docs/topics/templates.txt
+++ b/docs/topics/templates.txt
@@ -226,6 +226,10 @@ tags:
            Athlete: {{ athlete_list.0.name }}
         {% endif %}
 
+    While the above example works, be aware that most template filters return
+    strings, so mathematical comparisons using filters will generally not work
+    as you expect. :tfilter:`length` is an exception.
+
 :ttag:`block` and :ttag:`extends`
     Set up `template inheritance`_ (see below), a powerful way
     of cutting down on "boilerplate" in templates.