[oXygen-user] Bug/Feature Request for Schema Documentation Generation

[W. Eliot Kimber]

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


www.innodata-isogen.com