[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] RE: xsl/xslt coding standard
Jeni wrote: > One possibility that came to mind, though, was being able to specify > one or more documentation-element namespaces for adding documentation > to the stylesheet. So something like: I've been using this form for some time, and follow it with a mix of Chris's javascript to trawl for all xsl files in the project directory, list them, then process them with a stylesheet to produce a revision history. Slightly different purpose, but similar goals. My basic stylesheet now dumps: <d:doc xmlns:d="rnib.org.uk/tbs#"> <revhistory> <purpose><para></para></purpose> <revision> <revnumber></revnumber> <date></date> <authorinitials>DaveP</authorinitials> <revdescription> <para></para> </revdescription> <revremark></revremark> </revision> </revhistory> </d:doc> from emacs for any new xsl file. New revision elements are added as needed. I've normally used xml comments (rather than <xsl:comment>) before each template. I find context for named templates a must. Regards DaveP - NOTICE: The information contained in this email and any attachments is confidential and may be legally privileged. If you are not the intended recipient you are hereby notified that you must not use, disclose, distribute, copy, print or rely on this email's content. If you are not the intended recipient, please notify the sender immediately and then delete the email and any attachments from your system. RNIB has made strenuous efforts to ensure that emails and any attachments generated by its staff are free from viruses. However, it cannot accept any responsibility for any viruses 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 XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|