Marion

Spengler

Digitale Publikationsprozesse

HOME

Entwicklung

Automatisierte Dokumentation für Omnimark-Konverter

Immer mehr Unternehmen setzen XML und SGML zur Herstellung ihrer Produkte ein. Doch damit steigt auch in den Unternehmen selbst die Zahl der Schnittstellen beziehungsweise Konverter. Diese sind leider oft nur schlecht dokumentiert, ihre Pflege daher schwierig.

Marion Spengler hat eine Methode entwickelt, die ihr ermöglicht, für von ihr erstellte Omnimark-Konverter automatisierte HTML-Dokumentationen zu generieren. Nach dem Prinzip der "selbst-dokumentierenden Programme", das auch bei JavaDoc (http://java.sun.com/j2se/javadoc/) angewandt wird, kann aus einem Omnimark-Konverter mit Hilfe eines weiteren Omnimark-Programms eine HTML-Dokumentation erstellt werden. Anforderungen an die Dokumentation können variiert werden und man kann bei jeder Programmänderung auf Knopfdruck sofort die entsprechend angepasste Dokumentation erhalten. Voraussetzung ist, dass man strukturierte Programme schreibt und diese gut kommentiert.

Marion Spengler liefert auf Wunsch die von ihr programmierten Omnimark-Konverter (Omnimark Version 5 bis 7) mit der entsprechenden HTML-Dokumentation aus.

"Learn the customer's weaknesses so you can better take advantage of him." (Ferengi Erwerbsregel Nr. 87)