我被要求记录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建议声明source属性应为“xs:anyURI”类型。显然,“BuinessDescription”和“TechnicalDescription”不是URI,并且将在整个架构中重复多次。因此,将source属性用作语义属性是否真的正确?
在XML Schema中http://shop.oreilly.com/product/9780596002527.do Eric van der Vlist建议这是可以接受的,但也反驳了这种观点,指出它可能导致互操作性问题。
答案 0 :(得分:3)
您可以在其中放置格式良好的xml而不仅仅是文本,因此不要将已知的标准属性混淆。只有<Business>This is the business...</Business><Technical>This is the technical....</Tecnhical>
个节点。