doc: Add screen-shorts of the sqlbox

4 files changed, 20 insertions, 1 deletions

diff --git a/doc/documentation.txt b/doc/documentation.txt
index 59fab0e..7914908 100644
--- a/doc/documentation.txt
+++ b/doc/documentation.txt
@@ -1,6 +1,7 @@
 = Interaktives SQL E-Learning Module
 :author: Jan Klemkow, Benjamin Franzke
 :lang: de
+:imagesdir: image
 
 == Einleitung
 
@@ -89,16 +90,34 @@ Aufgabenstellung in Textform und eine Musterlösung in Form einer
 SQL-Anfrage-Strings an.
 Der Student muss Anhand des Aufgabentextes eine SQL-Anfrage formulieren welche
 diese Aufgabe löst.
+
+.SQLBox mit ausgeführtem Query
+image::sqlbox.png[]
+
 Die SQL-Anfrage der Musterlösung sowie die des Studenten werden beide
 nacheinander auf einer realen PostgreSQL-Datenbank ausgeführt.
 Die dabei entstehenden Antworten werden verglichen und bei Übereinstimmung 
 aller Zeile gilt diese Aufgabe fuer den Studenten als Bestanden.
+Während der Entwicklung des Queries hat der Nutzer, wie in Abbildung 1 zu sehen,
+die Möglichkeit, die Ergebnistabelle seiner Anfrage zu sehen.
+Auch mögliche Fehler in dem SQL-Statement, zurück gegeben vom PostgreSQL server,
+werden dem Studenten angezeigt.
+
 Der Tutor kann den Lernfortschritt aller Studenten anhand einer
-Übersichtstabelle verfolgen.
+Übersichtstabelle (Abbildung 2) verfolgen.
 In dieser Tabelle werden alle SQLBox-Aufgaben sowie alle Benutzer einander
 gegenüber gestellt und zusätzlich der Gesamtfortschritt pro Benutzer angezeigt.
+
+.Resultate aller Benutzer für alle Aufgaben mit Fortschrittsanzeige
+image::reportall.png[]
+
 Außerdem gibt es eine weitere Tabelle die jeweils für eine SQLBox die von den
 Teilnehmern zuletzt angegebene Lösungen -- ob falsch oder richtig -- anzeigt.
+Diese ist in Abbildung 3 zu sehen.
+
+.Resultate einer SQLBox mit Anzeige der SQL-Anfragen
+image::report.png[]
+
 
 Alle SQLBox-Instanzen in einer Moodle-Installation beziehen sich auf die selbe,
 einmalig konfigurierte Datenbank. Die Konfiguration der zu nutzenden Datenbank
diff --git a/doc/image/report.png b/doc/image/report.png
new file mode 100644
index 0000000..d31b8e3
--- /dev/null
+++ b/doc/image/report.png
diff --git a/doc/image/reportall.png b/doc/image/reportall.png
new file mode 100644
index 0000000..40bc7ab
--- /dev/null
+++ b/doc/image/reportall.png
diff --git a/doc/image/sqlbox.png b/doc/image/sqlbox.png
new file mode 100644
index 0000000..8db5684
--- /dev/null
+++ b/doc/image/sqlbox.png