How to-Dokument ein XML-Schema?
Ich entwickelte ein XML-schema für eine Anwendung die ich geschrieben habe. Jetzt möchte ich Dokument gültige Struktur für den Endbenutzer, allerdings kann ich nicht kommen mit einem natürlichen Weg, dies zu tun. Ich habe Dinge gesehen, wie xs3p, die im wesentlichen wandelt ein xsd-schema in eine HTML-Darstellung, jedoch nicht Aussehen wie eine gute Dokumentation für mich; der Benutzer sollte nicht wissen müssen, alles über schemas zu verstehen, was er tun darf.
Irgendwelche Ideen, wie dokumentieren Sie diese? Alle Programme /Editoren /grafische Lösungen oder einfach Begriffe, die ich bauen kann?
Schreibe einen Kommentar
Du musst angemeldet sein, um einen Kommentar abzugeben.
Der beste Weg (nach 6 Jahren Erfahrung mit xsd und die Gestaltung/Programmierung system-zu-system-Schnittstellen) meiner Meinung nach ist die Verwendung des xsd:documentation und xsd:annotation, die entworfen sind, für diese. Diese Art der XSD ist selbst dokumentieren (ähnlich wie die java-doc haben Sie in den source-code) und die Dokumentation wird immer verteilt, mit XSD. Betrachten Sie das Beispiel aus hier und wie die Dokumentation gezeigt wird, in-Stelle in einem XML-editor.
Wenn Sie nicht wollen, dies zu tun, dann schlage ich vor, Sie betrachten dieses post Wie konvertieren von xsd zu menschlich lesbare Dokumentation?