title: May xs:documentation contain HTML tags?
body: <p>My goal is to make a programmer's manual to my web-service. There are many tools that generate manuals directly from XSD source, and these tools use <code>&lt;xs:documentation&gt;</code> intensively.</p>
  
  <p>So I'm adding a much as possible <code>&lt;xs:documentation&gt;</code> tags to my XSD.</p>
  
  <p>Question: may <code>&lt;xs:documentation&gt;</code> contain HTML code, e.g. hyperlinks? Formally, it MAY while HTML contain is valid XML. But will this content be supported by third-party tools like manual generators mentioned above?</p>