Online-Dokumentation

Online-Dokumentation
Dieser Artikel oder Abschnitt bedarf einer Überarbeitung. Näheres ist auf der Diskussionsseite angegeben. Hilf mit, ihn zu verbessern, und entferne anschließend diese Markierung.

Mit Softwaredokumentation bezeichnet man die Dokumentation von Anwendungsprogrammen. Diese Dokumentation kann entweder so gemeint sein, dass ein Quellcode beschrieben wird, damit es später leichter ist, Fehler zu entdecken oder Änderungen vorzunehmen – oder es ist die Beschreibung des eigentlichen Softwareproduktes gemeint, also die Beschreibung der Benutzerschnittstelle und wie welche ihrer Teile anzuwenden sind.

Benutzerdokumentation

Die Benutzerdokumentation dient dazu, dem Benutzer die Anwendung des Programms zu erklären. Zu ihr gehören Handbücher, die Hilfefunktion im Programm selbst und Online-Dokumentationen. Sie sollte in einer für den Benutzer verständlichen Sprache abgefasst sein und Fachbegriffe in einem Glossar erklären.

Code-Dokumentation

Beim Erstellen von Software reicht es – vor allem, wenn mehrere Personen beteiligt sind – oft nicht aus, nur den Quellcode zu schreiben: Es ist eine Beschreibung der einzelnen Funktionen usw. nötig. Die Beschreibung ist normalerweise sehr technisch orientiert und beschreibt Programmierschnittstellen, Datenstrukturen oder Algorithmen. Wichtig ist hier, dass die Dokumentation des Codes alles wichtige erfasst, jedoch trotzdem so kurz wie möglich ist.

Oft werden mittlerweile Dienstprogramme wie z. B. Doxygen oder Javadoc verwendet, um die Dokumentation aus dem Quelltext heraus automatisch zu erstellen. Dies geschieht mittels Kommentaren im Code, die von den Dienstprogrammen herausgesucht und zu einer Referenz zusammengestellt werden.

Dieser Ansatz ist bei vielen Programmierern sehr beliebt, da er es ermöglicht, die Dokumentation zu verfassen, während man am Quelltext arbeitet. Man kann hier daher auch gleich in der gewohnten Umgebung weiterarbeiten und muss sich wegen der Dokumentation nicht extra in ein neues komplexes Programm einarbeiten. Auf der anderen Seite ist es jedoch nur Programmierern möglich, die Dokumentation zu editieren. Manche sehen dies aber auch als Vorteil.

Bei der Dokumentation der Benutzerschnittstelle wird besonders auf die Dokumentation des Funktionsumfanges des Programms oder des Programmmodules Wert gelegt. Beim Erstellen einer solchen Dokumentation ist auf Sauberkeit und Vollständigkeit zu achten.

Zusätzlich zur eigentlichen Dokumentation können Links angelegt werden, die nähere Informationen der Prozedur oder der Klasse oder sonstigen Programmiersprachelementen geben.

Siehe auch


Wikimedia Foundation.

Игры ⚽ Нужно сделать НИР?

Schlagen Sie auch in anderen Wörterbüchern nach:

  • Online-Dokumentation — eine Form der ⇡ Dokumentation eines Softwareprodukts, die der Benutzer unmittelbar bei der Arbeit am Bildschirm abrufen kann, z.B. durch „Hilfe Bildschirme“ …   Lexikon der Economics

  • Dokumentation — 1. Prozess der Erstellung von Dokumenten: Die D. muss in allen Phasen des Software Engineerings entwickelt und ständig aktualisiert werden. 2. Verschiedene Dokumente: Alle im Software Life Cycle entstehenden schriftlichen Ausarbeitungen (⇡… …   Lexikon der Economics

  • Online-Filmdatenbank — www.ofdb.de Kommerziell Ja Beschreibung …   Deutsch Wikipedia

  • Dokumentation (Technik) — Eine Technische Dokumentation (auch: Technikdokumentation oder Produktdokumentation) ist die Gesamtheit von Dokumenten, die ein technisches Erzeugnis beschreiben. Merkmal der Technischen Dokumentation ist die systematische Aufbereitung und die… …   Deutsch Wikipedia

  • Dokumentation — Unter Dokumentation versteht man die Nutzbarmachung von Informationen zur weiteren Verwendung. Ziel der Dokumentation ist es, schriftlich oder auf andere Weise dauerhaft niedergelegte Informationen (Dokumente) gezielt auffindbar zu machen.… …   Deutsch Wikipedia

  • Online-Auktion — Auktionator und Assistenten in Cheviot, Ohio Eine Auktion (auch Versteigerung oder Lizitation) ist eine besondere Form der Preisermittlung. Dabei werden von potentiellen Käufern und/oder Verkäufern Gebote abgegeben. Der Auktionsmechanismus… …   Deutsch Wikipedia

  • Dokumentation lebensgeschichtlicher Aufzeichnungen — Die Dokumentation lebensgeschichtlicher Aufzeichnungen im Rahmen des Instituts für Wirtschafts und Sozialgeschichte der Universität Wien ist eine Sammelstelle für populare Autobiografik und umfasst heute etwa 3000 großteils unveröffentlichte… …   Deutsch Wikipedia

  • Online Public Access Catalogue — Ein Bibliothekskatalog ist ein Verzeichnis von Publikationen (Medien) oder Sammlungen in einer Bibliothek. Traditionell sind vor allem Bücher verzeichnet. Zu unterscheiden sind der nach Verfassern und Elementen des Titels geordnete alphabetische… …   Deutsch Wikipedia

  • Online-Demonstration — Eine Online Demonstration oder ein Virtuelles Sit In ist eine politische Aktionsform des Internet Zeitalters. Durch wiederholtes Aufrufen einer bestimmten Homepage von zahlreichen Computern aus und innerhalb einer festgelegten Zeitspanne wird… …   Deutsch Wikipedia

  • Online-Demo — Eine Online Demonstration oder ein Virtuelles Sit In ist eine politische Aktionsform des Internet Zeitalters. Durch wiederholtes Aufrufen einer bestimmten Homepage von zahlreichen Computern aus und innerhalb einer festgelegten Zeitspanne wird… …   Deutsch Wikipedia

Share the article and excerpts

Direct link
Do a right-click on the link above
and select “Copy Link”