Mustergestützte Softwaredokumentation
Motivation für die Software- Dokumentation Wartung nimmt immer größeren Stellenwert einWartung nimmt immer größeren Stellenwert ein Einarbeitungszeit verkürzenEinarbeitungszeit verkürzen Wiederverwendung motivierenWiederverwendung motivieren Produktivität steigernProduktivität steigern
Dokumentation für den Endanwender Framework-Tutorien im WandelFramework-Tutorien im Wandel BeispieleBeispiele Einsatz von Mustern in der Dokumentation von FrameworksEinsatz von Mustern in der Dokumentation von Frameworks Visuallessons by Ian ChaiVisuallessons by Ian Chai
Dokumentation für den Endanwender Minimalist DocumentationMinimalist Documentation HypertextHypertext MusterMuster
Guidelines für Minimalist Documentation: Training on real tasksTraining on real tasks Getting started fastGetting started fast Reasoning and improvisingReasoning and improvising Reading in any orderReading in any order Coordinating System and TrainingCoordinating System and Training Supporting Error Recognition and RecoverySupporting Error Recognition and Recovery Exploiting Prior KnowledgeExploiting Prior Knowledge Using the SituationUsing the Situation
Systemdokumentation Warum ist System-Dokumentation notwendig?Warum ist System-Dokumentation notwendig? Werkzeuge zur System-DokumentationWerkzeuge zur System-Dokumentation
Werkzeuge zur System- Dokumentation Rational Rose & SoDA Javadoc JBuilder
Projektdokumentation Das Vorgehensmodell VM-BasisDas Vorgehensmodell VM-Basis Projektdokumentation mit SoDoMProjektdokumentation mit SoDoM
SoDoM - Die Komponenten Das Word-FrontendDas Word-Frontend Das Browser-FrontendDas Browser-Frontend Die GlossardatenbankDie Glossardatenbank Konfigurationsmanagement mit Continuus CMKonfigurationsmanagement mit Continuus CM
Diskussionspunkte (1) Was sind die Perspektiven der Softwaredokumentation?Was sind die Perspektiven der Softwaredokumentation? Wie ist es möglich, Software- dokumentation in der Industrie zu etablieren?Wie ist es möglich, Software- dokumentation in der Industrie zu etablieren? Dokumentation von Hardware als Vorbild?Dokumentation von Hardware als Vorbild?
Diskussionspunkte (2) Wird der Begriff des „Pattern“ oft zu unrecht verwendet?Wird der Begriff des „Pattern“ oft zu unrecht verwendet? In welcher Weise können Entwurfsmuster Software dokumentieren?In welcher Weise können Entwurfsmuster Software dokumentieren? HTML und XML als Dokumentationswerkzeuge?HTML und XML als Dokumentationswerkzeuge?