Bug/Feature Request for Schema Documentation Generation

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@innodata-isogen.com www.innodata-isogen.com

Hello, Thank you for the request. We will consider it for a future version. Yes, a more appropriate place for the attribute annotation is where the attribute is defined, that is one of the Logical Diagram and Diagram sections instead of the XML Instance Representation one. The text of the annotation could be added in the diagram next to the rectangle with the attribute name. Regards, Sorin W. Eliot Kimber wrote:
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?
participants (2)
-
Sorin Ristache
-
W. Eliot Kimber