我被要求记录一个 XML Schema 文件。我需要包含每个模式元素的业务和技术描述。查看我们的指南和 W3C XML Schema 建议,我发现自己想知道最佳实践究竟是什么。
我们的指南规定注释标签应具有以下格式:
<xs:annotation>
<xs:documentation source="BusinessDescription">This is the business description</xs:documentation>
<xs:documentation source="TechnicalDescription">This is the business description</xs:documentation>
</xs:annotation>
XML 建议声明源属性的类型应为“xs:anyURI”。显然,“BuinessDescription”和“TechnicalDescription”不是 URI,并且会在整个模式中多次重复。因此,将源属性用作语义属性真的正确吗?
在 XML Schema http://shop.oreilly.com/product/9780596002527.do中,Eric van der Vlist 建议这是可以接受的,但也与此观点相矛盾,指出这可能导致互操作性问题。