doc: Refine test-scenario and sqlbox section

1 files changed, 27 insertions, 21 deletions

diff --git a/doc/documentation.txt b/doc/documentation.txt
index e93641f..a9deb2e 100644
--- a/doc/documentation.txt
+++ b/doc/documentation.txt
@@ -70,33 +70,39 @@ Für Moodle ist ein integriertes Video-Plugin verfügbar.
 
 == SQLBox
 
-``SQLBox'' ist ein Moodle-Modul, welches im Rahmen des Mulimedia-Projekts
-entstanden ist.
-Mit diesem Modul lassen sich Aufgaben fuer Datenbanken Anhand eines Beispiels
+``SQLBox'' ist der Name des Aktivitätsmodul, welches die Möglichkeit
+bietet SQL Lerntests in Moodle zu integrieren.
+Es ist als Projekt des Faches ``Multimedia-Projekt'' implementiert worden.
+Mit diesem Modul lassen sich Aufgaben für Datenbanken Anhand eines Beispiels
 formulieren.
-Der Tutor, welcher einen Lernkurs fuer Datenbanken verwaltet, gibt dabei eine
-Aufgabenstellung in Textform und eine Musterloesung inform eines SQL-Strings an.
-Der Student muss Anhand des Aufgabentextes einen SQL-Anfrage formulieren welche
-diese Aufgabe loest.
-Der die SQL-Anfrage der Muterloesung sowie die des Studenten werden beide
-nacheinander auf einer Realen PostgreSQL-Datenbank ausgefuert.
-Die dabei entstehenden Antworten werden verglichen und bei Uebereinstimmung gilt
-gilt diese Aufgabe fuer den Studenten als Bestanden.
-Der Tutor kann den Lernsoftschritt aller Studenten anhand einer
-Uebersichtstabelle verfolgen.
-In dieser Tabelle werden alle SQLBox-Aufgaben sowie alle Bentzer einander
-gegenueber gestellt und zusätzlich der Gesamtfortschritt pro Benutzer angezeigt.
+Der Tutor, welcher einen Lernkurs für Datenbanken verwaltet, gibt dabei eine
+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.
+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.
+Der Tutor kann den Lernfortschritt aller Studenten anhand einer
+Übersichtstabelle verfolgen.
+In dieser Tabelle werden alle SQLBox-Aufgaben sowie alle Benutzer einander
+gegenüber gestellt und zusätzlich der Gesamtfortschritt pro Benutzer angezeigt.
+
+Alle SQLBox-Instanzen in einer Moodle-Installation beziehen sich auf die selbe,
+einmalig konfigurierte Datenbank. Die Konfiguration der zu nutzenden Datenbank
+ist also nur einmalig auszuführen.
 
 === Das Test-Szenario
 
 Alle SQLBoxen finden im selben Beispiel-Szenario statt.
-Dieses Szanario ist in der Datenbank ``sqlbox'' abgebildet.
+Dieses Szanario ist in der dafür im Administrationbereich
+konfigurierten Datenbank (Standard: ``sqlbox'') abgebildet.
 Im Rahmen dieser Arbeit wurde das von Nils Weber entwickelte KAPV-Beispiel
-uebernommen.
-Es ist moeglich dieses Szenario zu erweitern oder auch ein vollkommen anderes
-zu erstellen, in man die Datenbank ``sqlbox'' anpasst.
-In einer Moodle-Instanz ist es momentan nicht moeglich mehrere verschiedene
-Beispielumgebungen fuer verschiedene SQLBoxen zu erstellen.
+übernommen.
+Es ist möglich dieses Szenario zu erweitern oder auch ein vollkommen anderes
+zu erstellen, indem das Datenbankschema manuell erweitert wird oder Datensätze
+hinzugefügt werden.
 
 === Separierung von Benutzern