Subject: [xsl] XSL - Documentation From: Stefan Krause <stf@xxxxxxxx> Date: Fri, 01 May 2009 12:23:07 +0200 |
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
Current Thread |
---|
|
<- Previous | Index | Next -> |
---|---|---|
[xsl] XSL-List Guidelines, Mulberry Technologie | Thread | Re: [xsl] XSL - Documentation, G. Ken Holman |
[xsl] XSL-List Guidelines, Mulberry Technologie | Date | Re: [xsl] XSL - Documentation, G. Ken Holman |
Month |