XML スキーマ ファイルの文書化を依頼されました。各スキーマ要素について、ビジネスおよび技術的な説明を含める必要があります。私たちのガイドラインと 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 は、これは受け入れられることを示唆していますが、相互運用性の問題につながる可能性があると述べて、この見解と矛盾しています。