Lists Home |
Date Index |
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
<!--pass the parameter myparam to dostuff template-->
<xsl:with-param name="myparam" select="$myparam"/>
documentation usually seems to me only to be useful when it is an
external document describing the process as a whole.