Re: [xsl] xsl/xslt coding standard

[Brian Grainger <granam at shaw dot ca>]

Since the W3C already defines documentation elements for schemas, why not 
just bring those over into XSLT 2.0.

A brief illustration is at 
http://www.xml.com/pub/a/2000/11/29/schemas/part1.html?page=7

Bringing these over into XSLT would require two new elements: 
xsl:annotation and  xsl:documentation. Nesting <xsl:documentation> within a 
parent <xsl:annotation> element might seem like overkill, since the 
<xs:appinfo> element from schemas is probably superfluous, but it would 
allow for the easy future addition of other types of documentation-related 
elements.

An XSLT processor would be expected to quietly ignore any children of 
<xs:annotation> which it didn't recognize.

Regards,
Brian.


XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list