XML-Know How

Zusätzlich zu den normalen XML-Kommentaren der Form <!-- Kommentartext --> kennt XSD das Anmerkungs-Element <xs:annotation> mit den Kindelementen <xs:documentation> für Dokumentationstexte und <xs:appInfo> für Software-Verarbeitungsanweisungen:

<xs:annotation>
  <xs:documentation>
    Doku-Text ...
  </xs:documentation>
</xs:annotation>

Das <xs:documentation>-Element darf am Anfang diverser XSD-Konstruktionen stehen. Es wird z. B. von Software verwendet, die aus der XSD und den Texten in <xs:documentation> automatisch eine kommentierte Strukturübersicht erstellt.

Die Verwendung von <xs:appInfo> ist völlig freigestellt:

<xs:annotation>
  <xs:appInfo>
    <tustep:procinf>noIndent</tustep:procinf>
  </xs:appInfo>
</xs:annotation>