I'm putting together a script that gathers all kinds of information about the XSL templates I have and the way that they are used in context of the entire system. One possible source of information could be code comments in the templates, so I've been looking for commenting conventions (along the lines of self-documenting code or even literate programming, though I'm unlikely to be willing to assume that much overhead)
Anyway, I found some discussion
here. I like
xsldoc best of anything I've found so far.
Dated: 09/11/2003