Wie dokumentieren Sie die Struktur von XML-Dateien

Wenn es darum geht zu dokumentieren, die Struktur von XML-Dateien...

Einer meiner co-Arbeiter hat es in eine Word-Tabelle.

Anderen fügt die Elemente in ein Word-Dokument mit Kommentaren wie diesem:

<learningobject id="{Learning Object Id (same value as the loid tag)}" 
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                xsi:noNamespaceSchemaLocation="http://www.aicpcu.org/schemas/cms_lo.xsd">




<objectRoot>
    <v>
        <!-- Current version of the object from the repository. !-->
        <!-- (Occurance: 1) -->
    </v>
    <label>
        <!-- Name of the object from the repository. !-->
        <!-- (Occurance: 0 or 1 or Many) -->
    </label>
</objectRoot>

Welche der beiden Methoden bevorzugt? Gibt es einen besseren Weg?

Gibt es andere Optionen, die nicht von Dritten Schema Documenter-tools zu aktualisieren?

InformationsquelleAutor der Frage joe | 2009-11-17

Schreibe einen Kommentar