My tendency is to use comments to logically partition the XSLT.
A few <!-- Section description --> rather than the inline comments arrangement.
Then again I am a big believer in small template (for matches), and tend to
include a comment above each named template.
My $0.02,
Ken Ross
Ph: +61 7 32359370
Mob: +61 (0)419 772299
Email: Ken(_dot_)Ross(_at_)iie(_dot_)qld(_dot_)gov(_dot_)au
-----Original Message-----
From: Ted Stresen-Reuter [mailto:tedmasterweb(_at_)mac(_dot_)com]
Sent: Wednesday, 19 February 2003 12:51 PM
To: XSL-List(_at_)lists(_dot_)mulberrytech(_dot_)com
Subject: [xsl] Should You Comment XSLT And If So, How?
Hi,
I joined this list what seems like several weeks ago now, at the outset
of a project I am working on (http://www.tedmasterweb.com/htdig/). I've
seen several fascinating conversations taking place here, in addition
to getting several truly excellent answers to what must have seemed
like incredibly dumb questions. In short, I'm fairly wowed and realize
I'm surrounded by rather enlightened beings.
Thank you all for your time, effort, and sense of humor.
As you can see by the Subject line, I'd like to know if you think you
should comment XSTL. And if so, How?
I'd like to say "here's what I do" but what provoked me to ask this
question was a realization that although XML can be commented, I don't
really find myself needing it or making much use of it when writing
XSLT (which is XML). The problem is, I've never seen an XML
application, just sample code. So, I was wondering, should you comment
XSLT and if so, How?
I sincerely look forward to your answers.
Peace.
Ted Stresen-Reuter
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
IMPORTANT: This email (including any attachments) may contain confidential,
private or legally privileged information and may be protected by copyright.
You may
only use it if you are the person(s) it was intended to be sent to and if you
use it in an
authorised way. No one is allowed to use, review, alter, transmit, disclose,
distribute,
print or copy this e-mail without appropriate authority.
If this e-mail was not intended for you and was sent to you by mistake, please
telephone or e-mail me immediately, destroy any hard copies of this e-mail and
delete
it and any copies of it from your computer system. Any legal privilege and
confidentiality attached to this e-mail is not waived or destroyed by that
mistake.
It is your responsibility to ensure that this e-mail does not contain and is
not affected
by computer viruses, defects or interference by third parties or replication
problems
(including incompatibility with your computer system).
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list