[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] Re: Should You Comment XSLT And If So, How?
Ted Stresen-Reuter wrote:
As you can see by the Subject line, I'd like to know if you think you should comment XSTL. And if so, How?
Take a look at the XSLT Standard Library [*], which includes standards for stylesheet engineering. The method of documentation used is modelled on that used by the DocBook stylesheets [at some stage I have to take a look at Norm Walsh's XWEB for literate programming in XSLT]. XSLTSL documentation takes the form of namespaced elements at the toplevel of the stylesheet. Every (public) template is documented, with information such as the purpose of the template, how it is to be used, parameters and expected results. One deficiency of this approach is that the documentation cannot be included inside a template itself. This was discussed last year (check the list archives). There was a suggestion to include an annotation mechanism in XSLT 2.0, whereas I suggested extending the whitespace stripping mechanism to also allow stripping of any elements. [*] http://xsltsl.sourceforge.net/ HTHs, 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
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|