>1. a schema for documenting XSLT (XSLTDocML, for sake of argument)




>There must be code-documenting mark-up languages out there 
>already that we
>could adapt if necessary.  Anyone know of any?

yes.... but IMHO xslt is an oddball.

Off the top of my head *some* of the key things to know about a stylesheet
might be.
1. 
prime purpose of  a simple template
e.g. Transforms element x into y/z


2. Exception processing
source document element a is processed within template for
element b because....

3. Use of global variables.
E.g. variable $root holds the content of document(....)

4. Interpretation of any special select patterns.
 E.g. this template selects all list items and does x.

5.   ??


Anyone like to add / amend?

Regards, DaveP


 XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list