Auswertung der Reviews zum Dokument v1.02

Autor: Uli Sacklowski
Datum: 28.11.00

1. Allgemeines

• Reviews
• sind gut gegliedert, klar im Ausdruck und mitunter sehr umfangreich,
• Zeiten, Moderatoren und Protokollanten werden teilweise genannt,

-> ein Review in ich-Form ohne Nennung Protokollant/Moderator   :-)
• nennen zahlreiche Informationsdefizite, Unklarheiten und Fehler. 
  -> Sie werden in der nächsten Pflichtenheft-Version berücksichtigt.
  
  
• einige weitere Bemerkungen
• Bemerkenswert ist der Umfang an erkannten Unklarheiten, fehlenden Informationen, Unstimmigkeiten und Fehlern, - dies insbesondere deshalb, weil hier schon einmal Reviews von Studenten eingearbeitet wurden.

-> Schwierigkeit eines vollständigen und fehlerfreien Pflichtenheftes
• Es gibt Hinweise zu nicht vorhandenen Dokumenten, z.B. zu Pflichtenheft, Hardware, Detektoren. 
  Vor ca. zwei Monaten gab es dieses Dokument noch. Es wurde wegen zu geringem Aussagewert und durch das neu erstellte Detektordokument gelöscht.

-> Problem der syntaktischen Eindeutigkeit von Verweisen (nicht Links), - dadurch Anzeigen aller Verweise möglich (z.B. grep)

Möglichkeit von Links zu nicht (mehr) vorhandenen Dokumenten.
-> Kontrollprogramm bekannt?

• :-)

Es wurden auch Bezüge über die Seitenzahl vorgenommen.
-> html-Format?
• :-) 
  ... ist  folgende Konstruktion falsch formuliert: "Beim Versuch, einen zweiten Detektor, und mit ihm ein zweites Zählerfenster zu öffnen...". Richtig sollte es heissen: "Beim Versuch, einen zweiten Detektor, umd mit ihm ein zweites Zählerfenster zu starten..."
• Einträge von Schlüsselworten sollten in einem Glossar erfolgen.
• Pflichtenheft-Struktur ist nichtformalisiert, daher ergeben sich Schwierigkeiten bei Herauslesen von IST und SOLL
• Da für die Detektoren eine grössere Anzahl von Menüs benutzt wird, haben wir beim Lesen eine Übersicht aller Menüs vermißt, die in einer Baumstruktur alle Pfade aufzeigt.
  -> Menü-Hierarchie
  -> auch Dialogfenster-Hierarchie?
  -> auch beides gemeinsam (Interaktionsdiagramme)?
• Sollte zu Beginn eine Aufzählung aller weiteren Pflichtenhefte erfolgen?
  -> üblich in Entwickler- und Nutzerdokumentationen