|
Programmdokumentation
Hallo zusammen,
mir stellt sich die Frage, wie ich ein produktiv eingesetztes Programm am besten dokumentiere, sodass ich nach Wochen/Monaten wieder schnell nachvollziehen kann, was ich da gemacht habe. Das soll mir natürlich auch eine Fehlersuche vereinfachen, falls diese später erforderlich sein sollte.
SubVIs dokumentiere ich über diesen Kontexthilfentext und damit bin ich auch sehr zufrieden.
Nur bin ich mir nicht sicher, wie ich das Programm selbst gut dokumentieren kann. Und zwar so, dass eine Archivierung der Doku z.B. im PDF-Format möglich ist.
Ich stelle mir so etwas in der Art vor: Die Doku wird z.B. mit Word erstellt.
Dann kommen allgemeine Hinweise. Evtl. mit Screenshot des Hauptprogramms und kurzen Erklärungen dazu (paralleles Einlesen von dies und jenem, Initialisierung etc).
Dann folgen Screenshots von SubVIs o.ä., die erläutern, was wo gemacht wird.
Nur ob das professionell ist, weiß ich nicht. Und professionell soll das schon aussehen.
Die "Doku", die LabVIEW generieren kann, ist meiner Meinung nach nicht gut. Da sehe ich dann die Hierarchie des Programms und Screenshots aller SubVIs mit sämtlichen Case-Fällen etc.
Was hat sich denn bewährt bzw. wie dokumentiert ihr eure Programme?
|
