Re: [xsl] xsl/xslt coding standard

[Jeni Tennison <jeni at jenitennison dot com>]

Mike Brown wrote:
> I add frequent comments to explain why I'm doing whatever I'm doing.

At an XSLT Q&A in Oxford recently, someone asked about adding comments
to stylesheets, and it made me think of the discussions we had ages
ago about the different ways of embedding *structured* comments in
a stylesheet. We talked then about using extension elements, but it's
a real pain because you have to have xsl:fallback in each of them to
stop processors getting worried.

One possibility that came to mind, though, was being able to specify
one or more documentation-element namespaces for adding documentation
to the stylesheet. So something like:

<xsl:stylesheet version="2.0"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
                xmlns:html="http://www.w3.org/1999/xhtml";
                documentation-element-prefixes="html">

<html:p>Here's some documentation of my stylesheet</html:p>

<xsl:template match="/">
  <html:p>And I can use it within templates too!</html:p>
  ...
</xsl:template>
                
</xsl:stylesheet>

What do y'all think?

Cheers,

Jeni

---
Jeni Tennison
http://www.jenitennison.com/


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