OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help



   RE: [xml-dev] Documenting XSLT (Was: Note from the Troll)

[ 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. 


I do not think ease of debugging is rationale to add documentation to

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 



News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS