Vorab-Information!
Mit softconcept sCodeDocu können direkt aus VB(A)-Code Dokumentationen generiert werden. Durch ein konfigurierbares System von Schlüsselwörtern kann zu Modulen, Prozeduren, etc. beschreibender Text definiert werden, der in die Dokumentation einfließt. Der Export ist nach XML oder fertig formatiert nach HTML möglich.
Es können Dokumentationen für unterschiedliche Adressaten generiert werden:
Im Startformular von softconcept sCodeDocu können diese drei Dokumentations-Arten erzeugt werden:
softconcept sCodeDocu analysiert den Quellcode eines Projekts und baut daraus eine interne Datenstruktur mit den für eine Dokumentation relevanten Daten auf. Auf dieser Basis bauen alle weiteren Schritte auf.
Der folgende Screenshot zeigt beispielsweise einen Ausschnitt der Übersichtsseite, die automatisch generiert wurde. Die Klartext-Beschreibungen werden direkt dem Quelltext entnommen. Statistische Informationen werden ermittelt.
Kommentare, die im Code zu bestimmten Elementen (Modulen, Prozeduren, Konstanten, Typen, Parametern, etc...) geschrieben sind, können nun auch unmittelbar in eine übersichtliche Dokumentation einfließen.
Hier sehen Sie einen kleinen Code-Ausschnitt mit kurzen Beschreibungen zur Funktionsweise der Prozedur und Beschreibungen für die Parameter:
Diese Kommentare werden nun direkt in die fertige Dokumentation übernommen:
softconcept sCodeDocu wird auch als Entwickler-DLL erhältlich sein, sodass Sie selbst die Dokumentation nach Ihren Vorgaben und Wünschen gestalten können.