From 729a8e8bcea420a856a2d577520e943968807ce1 Mon Sep 17 00:00:00 2001
From: Gregor Kleen <gregor.kleen@ifi.lmu.de>
Date: Wed, 15 Jan 2020 16:35:04 +0100
Subject: [PATCH] fix: improve csv import explanation

---
 .../de-de-formal.hamlet                       | 47 ++++++++++++-------
 .../table/csv-import-explanation/en-eu.hamlet | 15 ++++--
 2 files changed, 43 insertions(+), 19 deletions(-)

diff --git a/templates/i18n/table/csv-import-explanation/de-de-formal.hamlet b/templates/i18n/table/csv-import-explanation/de-de-formal.hamlet
index 33d4609ef..992aba4b6 100644
--- a/templates/i18n/table/csv-import-explanation/de-de-formal.hamlet
+++ b/templates/i18n/table/csv-import-explanation/de-de-formal.hamlet
@@ -10,37 +10,52 @@ $newline never
       diesem Fall wird die fehlende Spalte so behandelt als enthielte sie in #
       jeder Zeile eine leere Zelle).<br />
       Spalten werden an ihrer Überschrift identifiziert. #
-      Die Überschrift darf daher nicht verändert oder entfernt werden.
+      Die Überschrift darf daher nicht verändert oder entfernt werden.<br />
+      Das verwendete Separator-Zeichen (Komma, Semikolon, Tabulator, #
+      ...) wird beim Import automatisch erkannt.<br />
+      Beim Import wird stets die selbe Zeichenkodierung erwartet, wie #
+      sie auch für den CSV-Export eingestellt ist.
     <dt .deflist__dt>Änderungen
     <dd .deflist__dd>
-      Einige Zellen können durch den Import verändert werden.<br />
-      Nicht-änderbare Zellen werden ignoriert, falls diese verändert wurden.
+      Bei den meisten Zellen wird durch den Import der Stand der #
+      Datenbank dem Inhalt der Zelle angepasst (z.B. ein #
+      Klausurergebnis).<br />
+      Bei Zellen, wo dies nicht möglich ist (z.B. die #
+      Maximalpunktezahl einer Teilaufgabe), werden etwaige #
+      Unterschiede zum Stand der Datenbank ignoriert.
     <dt .deflist__dt>Vorschau
     <dd .deflist__dd>
-      Es wird eine Vorschau angezeigt, bevor irgendetwas tatsächlich geändert wird.<br />
-      In der Vorschau können dann auch nur teilweise Änderungen ausgewählt werden.
+      Es wird eine Vorschau angezeigt, bevor irgendetwas tatsächlich #
+      geändert wird.<br />
+      In der Vorschau kann dann auch eine beliebige Teilmenge der #
+      Änderungen zur Anwendung ausgewählt werden.
     <dt .deflist__dt>Leere Zellen
     <dd .deflist__dd>
-      Löschbare Zellen werden durch leere Zellen gelöscht oder auf eindeutige Werte gesetzt.
+      Löschbare Zellen werden durch leere Zellen gelöscht oder auf #
+      eindeutige Werte gesetzt.
     <dt .deflist__dt>Konsistenz
     <dd .deflist__dd>
       <p>
         Es werden nur konsistente Änderungen akzeptiert!
       <p>
-        Daraus folgt, dass es sinnvoll sein kann, gewisse Zellen frei zu lassen; #
-        ändert man z.B. die Studienfachzuordnung eines Teilnehmers ab, #
-        so müsste man auch Abschluss und Fachsemester passend ändern.<br />
-        Da diese jedoch eindeutig sind, kann man diese Zellen einfach frei lassen.
+        Daraus folgt, dass es sinnvoll sein kann, gewisse Zellen frei #
+        zu lassen; ändert man z.B. die Studienfachzuordnung eines #
+        Teilnehmers ab, so müsste man auch Abschluss und #
+        Fachsemester passend ändern.<br />
+        Da diese jedoch eindeutig sind, kann man diese Zellen einfach #
+        frei lassen.
     <dt .deflist__dt>Zeilen Identifikation
     <dd .deflist__dd>
-        Mehrere Spalten werden zur Identifikation der Zeile verwendet.<br />
-        Es muss nicht in jeder Spalte der Zeile ein Wert vorhanden sein, #
-        so lange die Identifikation noch eindeutig ist.<br />
-        Sind mehrere Werte vorhanden, so müssen diese natürlich zueinander passen.
+        Mehrere Spalten werden zur Identifikation der Zeile #
+        verwendet.<br />
+        Es muss nicht in jeder Spalte der Zeile ein Wert vorhanden #
+        sein, so lange die Identifikation noch eindeutig ist.<br />
+        Sind mehrere Werte vorhanden, so müssen diese natürlich #
+        zueinander passen.
     <dt .deflist__dt>Zeilen hinzufügen
     <dd .deflist__dd>
-        Es können auch neue Zeilen hinzugefügt werden, sofern ausreichend #
-        eindeutige Informationen vorhanden sind; #
+        Es können auch neue Zeilen hinzugefügt werden, sofern #
+        ausreichend eindeutige Informationen vorhanden sind; #
         z.B. können so Prüfungsteilnehmer nachgemeldet werden.
     <dt .deflist__dt>Zeilen löschen
     <dd .deflist__dd>
diff --git a/templates/i18n/table/csv-import-explanation/en-eu.hamlet b/templates/i18n/table/csv-import-explanation/en-eu.hamlet
index a22231c5a..f6205dbda 100644
--- a/templates/i18n/table/csv-import-explanation/en-eu.hamlet
+++ b/templates/i18n/table/csv-import-explanation/en-eu.hamlet
@@ -10,11 +10,20 @@ $newline never
       the column will be treated as if every cell contained within it was #
       empty).<br />
       Columns are identified based on their heading. #
-      Thus column headings may not be modified or removed.
+      Thus column headings may not be modified or removed.<br />
+      The separator character (comma, semicolon, tabulator, ...) is #
+      detected automatically during import.<br />
+      Imported files are expected to use the character encoding, that #
+      is configured for CSV-export.
     <dt .deflist__dt>Edits
     <dd .deflist__dd>
-      Some cells can be changed when importing.<br />
-      Cells that cannot be changed are ignored, if they were changed.
+      For most cells, importing changes the current state of the #
+      database to reflect the content of the imported cell (i.e. exam #
+      results).<br />
+      For some cells this is not possible (i.e. the maximum number of #
+      points of an exam part). #
+      In that case all differences between the current state of the #
+      database and the content of the imported cell are ignored.
     <dt .deflist__dt>Preview
     <dd .deflist__dd>
       Before any edits are applied a preview is shown of what would be done.<br />