RE: commenting and documenting XSLT (small survey)

    -----Original Message-----
    From: christof.hoeke@xxxxxxx


    another reason to use <!-- --> comments is that in almost 
    all editors they are highlighted (or better lowlighted...) 
    so are much easier to recognize and differentiate from 
    actual content.
    using elements in another namespace (even a special doc 
    namespace) would somehow pollute the content i think.

Or document the content?

    
    i guess an element as <annotation> in XML Schema is there 
    for a purpose but probably not to make the Schema better 
    maintainable which I think the main purpose comments in 
    general are for.

I'd suggest that the annotation element is for annotations?

XML comments are one thing.
XML documentation is another, and can be used as either metadata,
content documentation or a host of other things, using xml tools.

XML comments have far less utility IMHO.

Just my 0.02Euros.

regards DaveP

-- 
DISCLAIMER: 

NOTICE: The information contained in this email and any attachments is 
confidential and may be privileged. If you are not the intended 
recipient you should not use, disclose, distribute or copy any of the 
content of it or of any attachment; you are requested to notify the 
sender immediately of your receipt of the email and then to delete it 
and any attachments from your system. 

RNIB endeavours to ensure that emails and any attachments generated by 
its staff are free from viruses or other contaminants. However, it 
cannot accept any responsibility for any  such which are transmitted.
We therefore recommend you scan all attachments. 

Please note that the statements and views expressed in this email and 
any attachments are those of the author and do not necessarily represent 
those of RNIB. 

RNIB Registered Charity Number: 226227 

Website: http://www.rnib.org.uk