Richtlinien
Protokollierung der Tutoriumssitzungen
Zu jeder Tutoriumssitzung der Gruppe X wird ein Protokoll angefertigt, das im
Postscriptformat im Verzeichnis
- /home/bwana/tnfink/Lehre/SWP-99/TutGrErg/TGX/Berichte/
abgelegt wird.
Erstellung der Entwurfsspezifikation
In der Entwurfsspezifikation sollen alle Bibliotheken mit ihren
Klassen, deren Funktionalität und Abhängigkeiten eindeutig beschrieben
werden. Dabei sollen die Möglichkeiten der Unified Modelling Language
(UML) intensiv eingesetzt werden. Die gesamte Entwurfsspezifikation wird im
Postscript-Format (von ghostscript lesbar) zur Bewertung abgegeben.
Planung der Implementierung
Vor der eigentlichen Implementierung wird ein Plan erstellt,
der folgendes enthalten soll:
- Aufteilung in kleine Arbeitsgruppen
Die notwendigen Arbeiten werden in kleine Pakete unterteilt, die
dann von einer Kleingruppe (2P) bearbeitet werden.
Jede Kleingruppe übernimmt abwechselnd das
Qualitätsmanagement. D.h., sie
testet die Implementierungen der anderen Gruppen, überprüft die
Einhaltung des Projektplans und schreibt den Projektabschlußbericht.
- Definition von Milestones
Es wird ein Zeitplan erstellt, in dem für bestimmte Arbeiten feste
Zeitpunkte definiert werden. Mindestens für die folgende Ereignisse
sollen Milestones definiert sein:
- Fertigstellung eines Prototyps, der den anderen Gruppen eine Evaluation des
künstlichen Spielers ermöglicht
- Beendigung der Programmierarbeiten
- Beendigung der Dokumentation
Der Projektplan wird schriftlich abgegeben.
Strukturierung des Programmcodes
Jede Arbeitsgruppe X generiert ihre Packages als Sub-Packages
von:
Der Quelltext jeder Gruppe wird gespeichert in:
- /home/bwana/tnfink/Lehre/SWP-99/TutGrErg/TGX/Java/
Die kompilierten Klassen aller Gruppen kommen nach:
- /home/bwana/tnfink/Lehre/SWP-99/TutGrErg/Org/Classes/
Programmdokumentation
Zur Erstellung der Programmdokumentation soll das Werkzeug
javadoc
eingesetzt werden, das eine Dokumentation innerhalb des Quellcodes mit
automatischer HTML-Generierung erlaubt. Jede Klasse soll vor der
Abgabe getestet werden. Ein erfolgreicher Test wird von dem Tester mit
seinem Namen und Datum des Tests in der Dokumentation zu der Klasse vermerkt.
Projektabschlußbericht
Der Projektabschlußbericht soll folgende Themen beinhalten:
- Bedienung des Systems,
(Aufrufsyntax und -semantik der Programme, Benutzerführung
innerhalb des Programmes)
- Besonderheiten und Schwächen der Implementierung,
- überblicksartige Darstellung der Programmstruktur
(dabei kann auf Material aus der Entwurfsspezifikation
zurückgegriffen werden),
- Unterschiede zur Entwurfsspezifikation und Ursachen,
- Erfahrungen mit der gemeinschaftlichen Projektarbeit
(Wie effektiv war die Aufgabenverteilung? Wie war die Koordination
zwischen den/innerhalb der Gruppen?).
- Individuelle Leistungen
(Auflistung der Teilnehmer in den einzelnen Untergruppen, besondere
Leistungen wie Vorträge, Überarbeitung
schriftlicher Dokumente etc.)
Optional können weitere Themen erörtert werden, wie z.B.
Möglichkeiten für künftige Verbeserungen/Erweiterungen
der Implementierung, Kritik am Softwarepraktikum.
Hinzukommend soll er folgenden technischen Anforderungen genügen:
- Frontseite mit Titel, Nummer der Tutorengruppe und Tutor,
- Nummerierung der Seiten,
- Strukturierung des Textes und ein Inhaltsverzeichnis,
- korrekte Rechtschreibung.