--- a/doc/upgrading.txt	Mon Jan 13 21:18:42 2020 +0000
+++ b/doc/upgrading.txt	Wed Jan 15 21:26:19 2020 +0000
@@ -258,6 +258,20 @@
 Jinja template changes
 ----------------------
 
+Auto escaping has been enabled in the jinja template engine, this
+means it is no longer necessary to manually escape dynamic strings
+with "|e", but strings that should not be escaped need to be marked
+with "|safe" (e.g. "{{ context.history()|u|safe }}"). Also, the i18n
+extension has been enabled and the template has been updated to use
+the extension for translatable text instead of explicit "i18n.gettext"
+calls:
+
+   {% trans %}List of issues{% endtrans %}
+
+instead of
+
+   {{ i18n.gettext('List of issues')|u }}
+
 The jinja template has been upgraded to use bootstrap 4.1.3 (from
 2.2.2). You can diff/merge changes into your jinja template based
 tracker.