froscon2008 - 1.1

FrOSCon
Free and Open Source Software Conference

Speakers
Carola Sammy Kummert
Schedule
Day Day 2 (2008-08-24)
Room HS5
Start time 10:00
Duration 01:00
Info
ID 272
Event type lecture
Track Development
Language used for presentation de
Feedback

Programmdokumentation leicht gemacht

Wenn aus Hass Liebe wird

Dokumentation zu schreiben ist wohl der meistgehasste Aspekt jeglicher Programmiertätigkeit. Wider besseren Wissens verzichtet man darauf und begründet dies gern mit "Das reichen wir später nach." Die nachträgliche Erstellung von Dokumentation wird dann jedoch meist zur Quälerei und frustriert sowohl Entwickler als auch im Ergebnis die späteren Nutzer. Wie man fast nebenbei und spielend einfach eine saubere Programmdokumentation erstellen, mit der auch der Uneingeweihte arbeiten kann, erklärt dieser Vortrag.

Im Mittelpunkt des Vortrags stehen nicht nur technische Hilfsmittel, die das Erstellen von Dokumentation erleichtern. Viel wichtiger ist häufig die Motivation der Programmierer, überhaupt Dokumentation zu erstellen, reichen doch die typischen Argumente gern von "Keine Zeit" bis "das sieht man doch im Code". Richtig gemacht ist Dokumentation hingegen etwas, das sich fast von selbst schreibt und kaum zusätzliche Ressourcen benötigt, ja, das im Zweifelsfall sogar Ressourcen schaffen kann.