For those reading this thread, Zimlet doco is available on this page:
http://www.zimbra.com/products/zimlets.html
And specifically, here:
http://www.zimbra.com/pdf/Zimbra%20Z...Whitepaper.pdf
(And yes I am slightly embarrassed at not noticing that link!)