Hello,

I was looking for the most common way to document XSL-Stylesheets and
found a lot of small solutions in the web, which belongs to one of these
groups:

1) use of comments, similar to JavaDoc
2) use of an extension namespace
3) literate programming

Since comments are restricted to pure text and literate programming is a
little bit out of my scope, I ended up with the use of an extension
namespace (XSLTdoc), which works fine for me.

There are several tools out in the wild, but as far as I can see there
is no widely spread solution. For example, OxygenXML supports none of them.

So, here are my questions:

1) Which tool do you use to create stylesheet documentations? What are
the pros and cons?

2) Is there a need (and a chance) for the xsl community to focus on one
singe tool, may be to encourage the software vendors to implement support?


Thanks,

Stefan

P.S.: A random list of related sources:
* http://www.dpawson.co.uk/xsl/sect2/documentation.html
* http://www.bacman.net/apps/XSLdoc/
* http://xsltsl.sourceforge.net/docbook-extensions.html
* http://www.linkwerk.com/pub/xslt/lib/xsltdoc/
* http://www.pnp-software.com/XSLTdoc/
* http://www.devx.com/getHelpOn/10MinuteSolution/20343/0/page/1
* http://www.kanzaki.com/parts/xsltdoc.xsl