[
Lists Home |
Date Index |
Thread 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
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.
|