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 | |
---|---|
Did you attend this event? Give 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.