Potential submitters may be interested in looking at XSLTdoc

to quote the doc:

     XSLTdoc is a Javadoc-like tool for all versions of XSLT
(1.0, 1.1,
2.0). It defines
      conventions to document "code elements" directly in
the source
code. These
      "documentation elements" are then extracted by the XSLTdoc
      tool to build a documentation consisting of several
linked HTML pages
      which provide easy browsing through the documentation. The
      XSLT source code is available with syntax highlighting.

I have converted my stylesheet collection to use this, and it
looks quite nice

Sebastian Rahtz