[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

XSL - Documentation

Subject: XSL - Documentation
From: Stefan Krause <stf@xxxxxxxx>
Date: Fri, 01 May 2009 12:23:07 +0200
 XSL - Documentation
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

PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.