Home. 
.

transparent

transparent

transparent

Altova Mailing List Archives


Re: [xsl] best practices for managing xsl library

From: James Fuller <jim.fuller@-------------->
To:
Date: 1/3/2006 7:03:00 AM
Chris Johnson wrote:

> Hi,
>
> Apart from the EXLT submissions page (http://www.exslt.org/
> submissions/) and the XSLT Standard Library (http://
> xsltsl.sourceforge.net/#id1954663), are there any good resources / 
> examples of best practices for managing a large library of xsl 
> templates?

I think all the XSLT STD Lib suggestions are fine to adopt.

btw which version of XSLT > XSLT 1.0 or 2.0 ?

Do you intend the library to be consumed or contributed too by public
users, if so striking the balance between the ease of 'submission'
versus completeness (re doc, tests, etc) can be quite tricky.

Handling versioning is another issue, would suggest to export versions
from source control with unique version number, rather then try to embed
and track changes by embedding revision type elements.

Do you intend to auto generate documentation from the library? If so you
may find embedding doc type elements directly inside xslt to be more
useful then have a seperate meta data document.

Who are your main users? for example with EXSLT we identified XSLT
processors implementators as a main user so they could use the doc.

I personally advise adopting concrete conventions only when they are
clearly enforceable (perhaps via a schema, schematron, etc), note that
most matters of style can usually be fixed at the submission/integration
process

Also I would first setup various testing harnesses so you are able to
automate test running (be it xslt style unit tests, or simple transforms
with input and expected output); it is important to be able to run tests
against all major processors, I use Ant for this....you may find that
this influences how you design your distro.

gl, Jim Fuller

note: DocBook has a considerable number of XSLT stylesheets as well and
lots of good advice embedded in it.


transparent
Print
Mail
Like It
Disclaimer
.

These Archives are provided for informational purposes only and have been generated directly from the Altova mailing list archive system and are comprised of the lists set forth on www.altova.com/list/index.html. Therefore, Altova does not warrant or guarantee the accuracy, reliability, completeness, usefulness, non-infringement of intellectual property rights, or quality of any content on the Altova Mailing List Archive(s), regardless of who originates that content. You expressly understand and agree that you bear all risks associated with using or relying on that content. Altova will not be liable or responsible in any way for any content posted including, but not limited to, any errors or omissions in content, or for any losses or damage of any kind incurred as a result of the use of or reliance on any content. This disclaimer and limitation on liability is in addition to the disclaimers and limitations contained in the Website Terms of Use and elsewhere on the site.

.
.

transparent

transparent