RE: Documenting XSLT (Was: Note from the Troll)
Bill de hÓra wrote >IMO, not having a documentation element in XSLT is a bonus for >debugging. The only thing developers are worse at than developing is >documenting what they develop. I have to agree there, aside from the fact that there is a reasonably well known convention of using namespaced elements in XSLT to handle documentation - http://www.jenitennison.com/xslt/utilities/paramDoc.html - Most documentation I see, of whatever sort, is absurd. Along the lines of <!--pass the parameter myparam to dostuff template--> <xsl:call-template name="dostuff"> <xsl:with-param name="myparam" select="$myparam"/> </xsl:call-template> documentation usually seems to me only to be useful when it is an external document describing the process as a whole.
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