OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help



   RE: [xml-dev] Documenting XSLT (Was: Note from the Troll)

[ 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

<!--pass the parameter myparam to dostuff template-->
<xsl:call-template name="dostuff">
<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.


News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS