Cart
[Home] [By Thread] [By Date] [Recent Entries]
-----Original Message----- From: AndrewWatt2000@a... [mailto:AndrewWatt2000@a...] Additionally, having a documentation element would assist debugging of XSLT stylesheets. >> Andrew, I do not think ease of debugging is rationale to add documentation to XSLT. But perhaps you're experience is very different to mine. In my experience, what eases debugging are tests, evidence, and fresh eyes. Documentation is the last place to look, since (if lucky), documentation will tell someone's intent or assumptions at some point in time. Programmer intent and assumptions are not things to be added to the debugging toolkit - if anything, they're harmful. >> If you use comments heavily for documentation it is more awkward to comment out sections of code since comments don't nest. If a documentation element existed I would expect that the debugging process would be easier. >> IMO, not having a documentation element in XSLT is a bonus for debugging. The only thing developers are worse at than developing is documenting what they develop. Bill de hÓra -- Propylon www.propylon.com
|
