Automatische Zusammenfassung von Quellcode-Kommentaren

Abstract

Softwaremodule werden in der Praxis oft nicht oder nur unzureichend spezifiziert und dokumentiert. An der Universität Stuttgart entstand daher das Dokumentationswerkzeug UniMoDoc. Soll ein bereits vorhandenes Modul in UniMoDoc nachdokumentiert werden, ist der damit einhergehende Aufwand hoch. Die Aufgabe eines Moduls hängt von den ihm untergeordneten Übersetzungseinheiten ab. Diese Arbeit nutzt diese Abhängigkeit, um aus den im Quelltext enthaltenen Kommentaren durch automatisches Zusammenfassen eine Moduldokumentation zu generieren. Diese soll den Einstieg in UniMoDoc erleichtern und als Ausgangspunkt für ein manuelles Überarbeiten oder Erweitern der Dokumentation dienen. Es werden zunächst der Kontext einer Moduldokumentation und die an sie gestellten Anforderungen vorgestellt. Ein auf der TF-IDF-Metrik und ein auf Latent Dirichlet Allocation (LDA) aufbauender Ansatz erfüllen diese Anforderungen. In einer intrinsischen Evaluation erzielt der LDA-Ansatz bessere Werte und wurde daher zu UniMoDoc hinzugefügt. Abschließend wird die auf dem LDA-Ansatz aufbauende Erweiterung extrinsisch evaluiert. Dabei zeigt sich, dass der Ansatz zufriedenstellende Zusammenfassungen generieren kann, sofern die vorhandenen Quelltextkommentare von ausreichend hoher Qualität sind.