Software-Tipps
Software > Software-Tipps > Softwaredokumentation

Softwaredokumentation


Einstufen und Bewerten der vorhandenen Softwaredokumentation

Eine Dokumentation ist eine geordnete Zusammenstellung und Nutzbarmachung von Informationen zur weiteren Verwendung.1 Für die Softwaredokumentation gibt es verschiedene Richtlinien und sie kann sogar die Grundlage zur Kauf- und Einsatzentscheidung bilden.

Eine Softwaredokumentation kann als eine Art Gebrauchsanleitung für Softwareprodukte verstanden werden. Für die Erstellung von Anleitungen gibt es die Norm DIN EN 62079 (VDE 0039). Diese Norm beschreibt neben Grundlagen detaillierte Anforderungen für den Entwurf und die Erstellung von technischen Anleitungen und Dokumentationen.

Die Softwaredokumentation wird beispielsweise als Online-Hilfe zusammen mit der Software an die Benutzer ausgeliefert. Sie sollte prozessorientiert strukturiert und leichten und schnellen Zugang zur gesuchten Information sicherstellen.2

Nach Wikipedia besteht eine vollständige Softwaredokumentation aus folgenden Teilen: 3

  • Programmiererdokumentation (Beschreibung des Quellcodes)
  • Methodendokumentation

    Beschreibung der mathematischen Algorithmen, technisch-wissenschaftliche oder kaufmännische Verfahren.

  • Installationsdokumentation
    • Beschreibung der erforderlichen Hardware, Software, mögliche Betriebssysteme, Standardbibliotheken oder Laufzeitsysteme
    • Erläuterung der Installation, Updates und De-Installation
  • Benutzerdokumentation (Handbuch, Online-Hilfe etc.)
  • Datendokumentation (Formate, Datentypen, Beschränkungen, Import- und Exportschnittstellen)
  • Testdokumentation
  • Entwicklungsdokumentation

Diese Dokumentationsbestandteile sind bei einer Individualsoftware sehr zweckmäßig. Bei einer Standardsoftware ist es in den meisten Fällen eher unüblich und unwahrscheinlich, den dokumentierten Quellcode mit ausgeliefert zu bekommen.4 Üblicherweise erhält man zusammen mit einer Standardsoftware Handbücher, Online-Dokumentationen,5 Test- und Demoversionen, Schnittstellendokumentationen, usw. Diese Bestandteile werden in den folgenden Abschnitten näher beschrieben.

Ein Kriterium der Softwaredokumenation stellt auch die Community bzw. deren Größe (z.B. Foren) dar.6 Hier finden Sie in der Regel Tipps und Tricks, FAQs, aber auch Hilfe bei Updates, Installationsproblemen und ähnlichem. Je größer die Community, desto wahrscheinlicher ist eine schnelle, kompetente und kostengünstige Lösung für ein Problem zu finden.


1 vgl. Wikipedia, Dokumentation, aufgerufen am 06.04.2023
2 Vgl. auch people text - Technische Dokumentation GmbH, Softwaredokumentation erstellen, aufgerufen am 06.04.2023
3 vgl. Wikipedia, Softwaredokumentation, aufgerufen am 06.04.2023
4 Ausnahmen bilden z.B. Open Source - Produkte
5 wie z.B. Foren, FAQs, Fehler-Datenbanken, Support Center
6 Dieser Hinweis kam von Herrn R. Albrecht von der FH Bielefeld.
Abkürzungen:
DIN: Deutsche Institut für Normung
EN: European Norm
VDE: Verband der Elektrotechnik
vgl.: vergleiche
GmbH: Gesellschaft mit beschränkter Haftung
FH: Fach Hochschule