Das Thema „Dokumentation“ ist im Rahmen von Softwareentwicklungsprojekten häufig wenig geliebt und gilt allenfalls als notwendiges Übel. Entsprechend besteht die Tendenz, die Dokumentation unter Zeitdruck, ungeplant und intuitiv zu schreiben. Die Frage danach, welche gesetzlichen oder normativen Anforderungen relevant sind, spielt dabei meist eine untergeordnete Rolle.

In dem Seminar wird untersucht, welche Anforderungen für welche Typen von Softwaredokumentation zu beachten sind. Dabei werden verschiedene Normen berücksichtigt, wie z. B. DIN EN 62079 „Erstellen von Anleitungen“ und ISO/IEC 26514 „Systems and software engineering - Requirements for designers and developers of user documentation“. Zudem wird die konkrete Umsetzung thematisiert. Hierbei spielen sowohl Fragen der Didaktik als auch Fragen nach technischen Hilfsmitteln eine Rolle.

Das Seminar vermittelt die wichtigsten Anforderungen aus Normen und Richtlinien ergänzt durch Kriterien, die sich aus der täglichen Redaktionspraxis ergeben.

Agenda