[
Lists Home |
Date Index |
Thread Index
]
-----Original Message-----
From: AndrewWatt2000@aol.com [mailto:AndrewWatt2000@aol.com]
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
|