SoDoM

Georg Odenthal
Klaus Quibeldey-Cirkel

E-mail-Verteiler: ReferentInnen und Seminarleitung

Software-Dokumentation mit Mustern

Informatik-Seminar und -Workshop im SS 1998

Die Vorträge wurden am 2. und 3. Juli 1998 gehalten. Am Nachmittag des zweiten Tages fand der Workshop statt - als deutschsprachige Pilot-Veranstaltung zum EuroPLoP-Workshop "Pattern-Aided Software Documentation" (in moderierter Gruppenarbeit nach der Metaplan-Methode).

Impressionen
Motivation

Projektgruppe "Software-Dokumentation" (besonders: Einführung)
und EuroPLoP-Workshop "Pattern-Aided Software Documentation"

Referentin/
Referent

Arbeitsthema

Literatur
(für eigene Recherchen siehe:
SIGDOC: Special Interest Group for DOCumentation
mit der Suchmaschine: ACM Digital Library)

Online-
Referat

1 Frau Ludwig-Rinn Software-Dokumentation:
gestern - heute - morgen
Theorie und Praxis der Wirtschaftsinformatik - HMD: Dokumentation

Lehner, Franz: Software-Dokumentation und Messung der Dokumentationsqualität.
München: Hanser, 1994. (UB-Signatur: 33TWQ3665)

DIN Dt. Inst. für Normung: Software: Entwicklung, Dokumentation, Qualität.
1995 (UB-Signatur: 50WBP1011(4)-166)

2 René Eßer Mustergestützte Software-Dokumentation Ian Chai: Pedagogical Framework Documentation
3 Jost Wiezorek Dokumentation objektorientierter Frameworks mit Entwurfsmustern Frameworks Home Page von Ralph E. Johnson

Documenting Frameworks Using Patterns by Ralph E. Johnson

4 Luigi Lo Iacono
Frank Pascher

(Projektgruppe W4C)

Dokumentenbasierte Software-Entwicklung:
am Beispiel V-Modell97 vs. VM-Basis (Telekom AG)
Das V-Modell: Der Entwicklungsstandard für IT-Systeme des Bundes

GI-Fachgruppe 5.1.1 "Vorgehensmodelle für die betriebliche Anwendungsentwicklung"

Begriffe und Konzepte

Ein Prozeßmanagementsystem für IT-Vorhaben nach dem V-Modell ’97

5 Thorsten Pelz Autoren-Frontend für die Software-Dokumentation  
6 Richard Schuller Konfigurations-Management
am Beispiel von Continuus®
Continuus-Hompage
7

Sven Dehmel

Aufbau und Funktion von Glossaren als Dokumentationsmittel  

8

Alexander Möller Donald E. Knuth: Literate Programming Web-Fundus zu "Literate Programming"

9

Markus Budzyn

Software-Dokumentation mit objektorientierten Konzepten Johannes Sametinger: Object-Oriented Documentation.
(ACM SIGDOC Journal of Computer Documentation) Volume 18, ACM Press, 1994.

Mary Elizabeth Raven und Richard Thomson: Can Principles of Object-Oriented System Documentation Be Applied to User Documentation?
(ACM SIGDOC Journal of Computer Documentation) Volume 18, ACM Press, 1994.

  • Was tun, wenn man gelesen werden möchte?
    Zum Beispiel die exzellente Stilfibel von Wolf Schneider lesen und danach schreiben: "Deutsch fürs Leben: Was die Schule zu lehren vergaß". Rowohlt-Verlag, 1994.
  • Beispiele für Referate: (kurz) (lang)
  • Beispiel für Vortragsfolien:
  • Tips für den Einsatz von PowerPoint: "Computer-Based Lectures Using PowerPoint" by Barbara Sommer and Winifred Anderson
  • Merkblatt zur Gestaltung eines Seminarvortrags