From 0217cff099a9f5b73b039d2728c6d893b296c80b Mon Sep 17 00:00:00 2001
From: Damien Elmes <gpg@ankiweb.net>
Date: Mon, 17 Feb 2020 09:06:54 +1000
Subject: [PATCH] add some comments to card-template-rendering.ftl

---
 rslib/src/i18n/card-template-rendering.ftl | 49 +++++++++++++++-------
 1 file changed, 34 insertions(+), 15 deletions(-)

diff --git a/rslib/src/i18n/card-template-rendering.ftl b/rslib/src/i18n/card-template-rendering.ftl
index 10a0d86e9..2402553f9 100644
--- a/rslib/src/i18n/card-template-rendering.ftl
+++ b/rslib/src/i18n/card-template-rendering.ftl
@@ -1,20 +1,39 @@
-front-side-problem = Front template has a problem:
-back-side-problem = Back template has a problem:
-
-## Error messages
-
-no-closing-brackets =
-  Missing '{$missing}' in '{$tag}'
-conditional-not-closed =
-  Missing '{$missing}'
-wrong-conditional-closed =
-  Found '{$found}', but expected '{$expected}'
-conditional-not-open =
-  Found '{$found}', but missing '{$missing1}' or '{$missing2}'
-no-such-field =
-  Found '{$found}', but there is no field called '{$field}'
+### These messages are shown on the review screen, preview screen, and
+### card template screen when the user has made a mistake in their card
+### template, or the front of the card is empty.
 
 # Label of link users can click on
 more-info = More information
 
+front-side-problem = Front template has a problem:
+back-side-problem = Back template has a problem:
+
+# when the user forgot to close a field reference,
+# eg, Missing '}}' in '{{Field'
+no-closing-brackets =
+  Missing '{$missing}' in '{$tag}'
+
+# when the user opened a conditional, but forgot to close it
+# eg, Missing '{{/Conditional}}'
+conditional-not-closed =
+  Missing '{$missing}'
+
+# when the user closed the wrong conditional
+# eg, Found '{{/Something}}', but expected '{{/SomethingElse}}'
+wrong-conditional-closed =
+  Found '{$found}', but expected '{$expected}'
+
+# when the user closed a conditional that wasn't open
+# eg, Found '{{/Something}}', but missing '{{#Something}}' or '{{^Something}}'
+conditional-not-open =
+  Found '{$found}', but missing '{$missing1}' or '{$missing2}'
+
+# when the user referenced a field that doesn't exist
+# eg, Found '{{Field}}', but there is not field called 'Field'
+no-such-field =
+  Found '{$found}', but there is no field called '{$field}'
+
+# This message is shown when the front side of the card is blank,
+# either due to a badly-designed template, or because required fields
+# are missing.
 empty-front = The front of this card is blank.