Mako provide cool filters, but I think documentation can be enhanced explaining, in HTML, where to use which filter. I mean, how to filter this :
${val1} <${val2} src="${val3}"/>
I was searching the right way to escape values of attributes, and got hard times to find it, Typically I'm a backend developper, not a front end, so I know that things has to be contextually escaped, but I don't exactly know which method escapes for which context.
So, presenting flags in http://docs.makotemplates.org/en/latest/filtering.html as a table, with 'name', 'explanation', 'usage contexts', 'example' should be usefull.