In my XSD schema I have attribute declarations with documentation
annotations within the attribute declaration, like so:
<xs:attribute name="number" type="xs:int" use="required">
<xs:annotation>
<xs:documentation>
<div xmlns="http://www.w3.org/1999/xhtml">
<h3>A Number</h3>
<p>A number from one to 10.</p>
</div>
</xs:documentation>
</xs:annotation>
I notice that the contents of the annotation is being output in the XML
Instance Representation following the type indictator.
This is not really very useful and certainly not what I expected.
Is this a bug in the schema generation? If it's not a bug, can I submit
a feature request to do something more useful with attribute-level
documentation, such as put it out following any element- type-level
documentation, labeled with the attribute name?
I'd take a shot at it myself right now except that I'm already fully
occupied at the moment.
For now I can just move the documentation up to the element but I really
want to have documentation bound as close to the thing documented as
possible.
Thanks,
Eliot
--
W. Eliot Kimber
Professional Services
Innodata Isogen
8500 N. Mopac, Suite 402
Austin, TX 78759
(214) 954-5198
ekimber(a)innodata-isogen.com
www.innodata-isogen.com
