Re: [xsl] standard method of documenting XSLT code?

Subject: Re: [xsl] standard method of documenting XSLT code?
From: Steve Ball <Steve.Ball@xxxxxxxxx>
Date: Fri, 26 Apr 2002 07:08:43 +1000
Daniel Veillard wrote:
On Wed, Apr 24, 2002 at 10:48:00AM -0500, Don Smith wrote:

Anyone done anything with documenting XSLT code, perhaps like the
<documentation> element in W3C Schemas?


  Norm Walsh has his own way he used for example in the docBook stylesheets,
have a look at them.

Further to that, DocBook has specific supprt for documenting computer software so it seems appropriate to use it for XSL stylesheets (which are, after all, simply another form of software).

This style of documentation is an essential part of
the engineering standards for the XSLT Standard Library
(http://xsltsl.sourceforge.net/).  There you can find quite
a few examples, as well as stylesheets to extract the
documentation from stylesheets and produce HTML,
all using XSLT instead of Make/Ant.

Cheers,
Steve Ball

--
Steve Ball            |   XSLT Standard Library   | Training & Seminars
Zveno Pty Ltd         |     Web Tcl Complete      |   XML XSL Schemas
http://www.zveno.com/ |      TclXML TclDOM        | Tcl, Web Development
Steve.Ball@xxxxxxxxx  +---------------------------+---------------------
Ph. +61 2 6242 4099   |   Mobile (0413) 594 462   | Fax +61 2 6242 4099


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



Current Thread