Einzelnen Beitrag anzeigen

CalganX

Registriert seit: 21. Jul 2002
Ort: Bonn
5.403 Beiträge
 
Turbo Delphi für Win32
 
#2

Re: Dokumentation für Programm erstellen

  Alt 23. Nov 2003, 12:00
Hi,
du hast eigentlich da Freiheit. Zumindest was das Format angeht. Meistens schreibe ich Dokumentationen in PDF (LaTeX bei mathematischen Sachen oder OpenOffice.org bei anderen Dingen). Allerdings kannst du das ganze auch in Form einer OnlineHilfe schreiben (.chm) oder ein einfaches Worddokument schreiben.
Zu Allen Möglichkeiten findest du in der DP was entsprechendes.

Der Aufbau sollte - meiner Meinung nach - ungefähr so aussehen:
  1. Einführung - Was macht dein Progamm? Womit hast du es geschrieben? Was ist der Sinn? etc.
  2. Dateien - Welche Dateien liegen dem Programm bei? Welche Funktion hat welche Datei? etc.
  3. Algorithmen - Welches Problem soll das Programm lösen? Welchen Algorithmus hast du verwendet? etc.
  4. Source-Dokumentation - Welche Funktion macht was? Erkläre den SourceCode! etc. (nur bei OpenSource)
  5. Abschluss - Quellen der Algorithmen, Dank ( ), etc.

Das im Groben. So sieht's bei mir zumindest meistens aus.

Chris
  Mit Zitat antworten Zitat