[Home] [By Thread] [By Date] [Recent Entries]


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/


Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member