XSL Transform Self-Documentation
http://www.idealliance.org/proceedings/xml05/abstracts/paper196.HTML

Tao, Sandy, Jeff Beck and Demian Hess
IDEAlliance
2005

Abstract:

The XSL stylesheets used at PubMed Central for data conversion present a particular challenge because documentation is needed not only for the reference of developers, but also for digital archivists to ensure that the conversion process conforms to accepted archiving standards. The choices that developers make in writing conversion filters need to be transparent and reviewable. To meet this need, we defined a format for inserting documentation into XSL stylesheets. The documentation had to be easy to maintain and needed to be capable of generating documentation for developers, archivists, and other stakeholders.