přímo součástí schématu může být dokumentace
pomocí XSLT lze pak generovat přehlednou dokumentaci schématu v HTML (http://titanium.dstc.edu.au/xml/xs3p/)
<xs:element name="zamestnanec"> <xs:annotation> <xs:documentation>Element slouží pro uchování důležitých údajů o zaměstnanci.</xs:documentation> </xs:annotation> <xs:complexType> <xs:annotation> <xs:documentation xmlns="http://www.w3.org/1999/xhtml"> <p>Dokumentace může být klidně v <a href="http://www.w3.org/TR/xhtml1/">XHTML</a>.</p> <ul> <li>a používat</li> <li>třeba</li> <li>seznamy</li> </ul> </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="jmeno" type="xs:string"/> <xs:element name="prijmeni" type="xs:string"/> <xs:element name="plat" type="xs:decimal"> <xs:annotation> <xs:documentation>Superhrubá mzda v Kč</xs:documentation> </xs:annotation> </xs:element> <xs:element name="narozen" type="xs:date"> <xs:annotation> <xs:documentation>Datum narození ve formátu RRRR-MM-DD</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType> </xs:element>