Dokumentation für Programm erstellen

[Kaiborg]

Hi!

Ich habe für die Schule ein Projekt geschrieben, was noch nich 100%ig funktioniert , mein Infolehrer war damit nich ganz einverstanden, und hat gesagt, er möchte dazu dann bitte eine Dokumentation haben , nur leider hat er nich gesagt, wie man eine Dokumentation zu schreiben hat , und auch nach intensiver Internetsuche habe ich keine vernünftige Anleitung dazu gefunden.
Wär schön, wenn mir jemand weiterhelfen könnte.
Danke im Voraus

[CalganX]

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

[HAF4ever]

oder einfach nur ein paar (* kommentare *) einfügen ...
wo halt drinnen steht was das prog macht bzw. machen soll

[Kaiborg]

Ok, danke!

Dann werde ich das mal noch bis morgen machen, sieht ja nicht so schwer aus , aber eine Frage noch, muss der Quellcode rein??

[HAF4ever]

der ganze source zahlt sich nicht aus ...
aber den code der wichtigsten prozeduren und funktionen schadet sicher nicht ...

[Luckie]

Zu den Algorithmen sollte man noch die mathematischen Grundlagen etwas erörtern. Und zum Schluss gehören da noch ein paar Testeingaben mit den Ausgaben dabei, sowohl Extremwerte, als auch normale. Und dabei müssen auch die Grenzen aufgeziegt werden, also bei welchen Werten dein Programm versagt.

[Karsten]

Die Funktionen sollten anhand von Flow-Charts beschrieben werden (nur die wichtigen, um prinzipielle Funktionsweisen zu erklären) und auf keinen Fall Quellcode in die Dokumentation reinnehmen.

Und wie Luckie schon sagte, 'mathematische Grundlagen' sind immer wieder sehr geeignet und auch wichtig.

Sollte sich irgenwann mal diese Frage während einer Diplomarbeit oder ähnliches stellen, kann ich da nur auf Erfahrungswerte zurückgreifen:

Note 1-2 bei denen die auf Quellcode verzichten und sich um prinzipielle Dinge gedanken machen

Note 3-4 bei denen die den Quellcode ans Ende kopieren um die Anzahl der Seiten zu erhöhen.

Gruß,
Karsten

[fenni]

Wichtig ist auch eine Erklärung, dass du das Programm ohne fremde Hilfe erstellt und eventuelle externe Quellen angegeben hast.

Der Quellcode gehört wenn überhaupt nur in den Anhang, ich würde ihn aber ganz weglassen und nur die wichtigsten Funktionen/Prozeduren in einem extra Kapitel über den Programmablauf an sich erläutern.

MfG
fenni

[HAF4ever]

wenn man schon keinen quellcode reinschreiben soll ...
wie siehts mit ablaufdiagrammen aus...? macht das einen guten eindruck wenn man für die wichtigsten algorythmen solche diagramme dazuzeichnet?

[Hansa]

Je nachdem, was Du genau jetzt meinst, vielleicht ja etwas anderes als ich, aber sehe ich irgendwo so ein paar bunte Bauklötze, Pfeile, die ins Nirwana zeigen und so nen Kram, dann hat dieses Programm bei mir schon verloren. Wie gesagt, nur meine Meinung Steht Dein Pauker auf so nem Kram, dann mach es halt.