Konventionen zum Kommentieren von Appinfo in XML-Schema?

Question

Ich glaube, dass die folgenden drei syntaktisch korrekt sind; aber welche sind nach Konventionen erlaubt (besonders im Unternehmen)?

---

Die erste unten in den meisten Beispielen verwendet wird, ich habe (zB JAXB) gesehen, aber es ist die ausführliche:

<xs:annotation> 
    <xs:appinfo> 
    <myinfo>don't panic</myinfo> 
    </xs:appinfo> 
</xs:annotation> 

Diese zweite unter erlaubt ist, da alle Attribute auf <appinfo> zulässig sind (die nicht im eigenen Namespace des XML-Schemas enthalten sind). Es ist kürzer und scheint vernünftig - aber ist es konventionell?

Das letzte unten ist mein Favorit, weil es so kurz ist und das Schema nicht überflutet. Ich bin mir sicher, dass es legal ist, denn wie <appinfo> sind alle Attribute auf einem <annotation> erlaubt (wieder vorausgesetzt, nicht-XML-Schemanamespaced). Aber es codiert Anwendungsinformationen ohne Verwendung einer <appinfo>, so dass ich befürchte, es wäre verpönt. Wäre es?

<xs:annotation myinfo="don't panic"/> 

Vielen Dank für Ihre Kommentare!

Answer 1

Ich glaube nicht, dass Sie etwas hören, weil ich nicht denke, dass diese Annotationen so häufig verwendet werden, und der ganze Sinn der Spezifikation besteht darin, jedem etwas zu erlauben, das ihnen dabei hilft.

Die einzige Konvention, die ich gesehen habe, ist die XHTML-Dokumentation, die natürlich nicht nach Ihren Möglichkeiten aussieht.

Sie könnten prüfen, ob Verarbeitungsbibliotheken wie Apache XmlSchema alle Ihre Optionen äquivalent behandeln.

Answer 2

Interessante Beispiele für eine etwas „Standard“ Nutzung von <xs:appinfo> sind bei http://docstore.mik.ua/orelly/xml/schema/ch14_02.htm und bei http://docstore.mik.ua/orelly/xml/schema/ch15_01.htm#ch15-77057

Beachten Sie, dass <xs:appinfo> Informationen enthalten soll, die von einer Anwendung verarbeitet werden, nicht für Menschen lesbare Noten (<xs:documentation> dafür verwenden).