David,
> If you want to stick some xhtml before each template saying what it
> does, just do so. What would a specific documentation element give
> you?
A documentation element (or a documentation namespace, which I'd
prefer) would enable me to stick *structured* documentation *within* a
template to explain a particular chunk of code.
We've discussed documentation work-arounds in XSLT 1.0 on and off for
years -- make the documentation elements extension elements and
include an empty xsl:fallback; run the stylesheet through a
de-documentation-izer before using it; use XML comments with XML
inside that you get out via disable-output-escaping.
None of these is exactly ideal.
Cheers,
Jeni
---
Jeni Tennison
http://www.jenitennison.com/
